> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usenash.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Nash exposes two MCP servers. The docs MCP server at https://docs.usenash.com/mcp searches this documentation and needs no credentials. The Nash MCP server at https://mcp.usenash.com/mcp operates an organization's deliveries and needs a Nash API key. See https://docs.usenash.com/reference/build-with-ai.
> Use the Sandbox environment (https://api.sandbox.usenash.com/v1) for anything that creates or dispatches deliveries during development.

# List Contracts

> List contracts visible to the authenticated organization. Returns a slim summary payload by default; pass include=details for the full record. Supports keyset pagination via the cursor returned in next_cursor.



## OpenAPI

````yaml get /v1/contracts
openapi: 3.1.0
info:
  title: Nash API
  version: 1.0.0
servers:
  - url: https://api.sandbox.usenash.com
    description: Sandbox API
  - url: https://api.sandbox.ap-southeast-2.usenash.com
    description: Sandbox API (Australia)
  - url: https://api.usenash.com
    description: Production API
  - url: https://api.ap-southeast-2.usenash.com
    description: Production API (Australia)
security: []
tags:
  - name: Notifications
    description: Notifications
    x-nash-topic: config
  - name: Annotate
    description: Annotate
    x-nash-topic: wismo
  - name: Notifications — Send
    description: One-off notification send without a NotificationTrigger.
    x-nash-topic: notifications
  - name: Shipping
    description: Shipping operations
    x-nash-topic: shipping
  - name: Workflow
    description: Workflow automation management
    x-nash-topic: scheduling
  - name: Workflow Execution
    description: Workflow execution history and monitoring
    x-nash-topic: scheduling
  - name: Optimization Strategies
    description: Create, read, update, and delete route optimization strategies.
    x-nash-topic: scheduling
  - name: AI Agents
    description: AI agent management — create, read, update, and delete agents
    x-nash-topic: config
  - name: AI Functions
    description: LLM-backed domain tools
    x-nash-topic: ai
  - name: Webhooks
    description: Webhook delivery inspection
    x-nash-topic: webhooks
  - name: Miscellaneous
    description: Miscellaneous
  - name: Job
    description: Job
    x-nash-topic: wismo
  - name: Batch Job
    description: Batch Job
    x-nash-topic: wismo
  - name: Order
    description: Order
    x-nash-topic: wismo
  - name: Provider
    description: Provider
    x-nash-topic: provider
  - name: Dispatch Strategies
    description: Dispatch Strategies
    x-nash-topic: scheduling
  - name: Store Locations
    description: Store Locations
    x-nash-topic: config
  - name: Delivery Windows
    description: Delivery Windows
    x-nash-topic: config
  - name: Templates
    description: Templates
    x-nash-topic: config
  - name: Zones
    description: Zones
    x-nash-topic: config
  - name: Feedback
    description: Feedback
    x-nash-topic: reporting
  - name: Organizations
    description: Organizations
    x-nash-topic: config
  - name: Store Catalog
    description: Store Catalog
    x-nash-topic: config
  - name: Route
    description: Route
    x-nash-topic: scheduling
  - name: Messaging
    description: Messaging
    x-nash-topic: config
  - name: Billing
    description: Invoice-aligned customer billing usage
    x-nash-topic: config
  - name: Contracts
    description: Provider contract pricing and version listings
    x-nash-topic: provider
  - name: Couriers
    description: Couriers
    x-nash-topic: provider
  - name: Fleet
    description: >-
      Inbound endpoints fleets call to manage their drivers and update in-flight
      deliveries.
    x-nash-topic: driver
  - name: Embed Sessions
    description: >-
      Mint short-lived, browser-safe sessions for embedded Nash Widgets.
      Authenticated with an org embed credential, which must stay on your
      backend.
    x-nash-topic: config
  - name: Event Timeline
    description: Entity-scoped event timeline + outbound provider traffic for one entity.
    x-nash-topic: internal
  - name: Files
    description: Stable links to files such as proof-of-delivery photos.
    x-nash-topic: wismo
  - name: Optimization Fleet Projection
    description: >-
      Optimizer-facing projection of the effective fleet for a single-store
      solve
    x-nash-topic: scheduling
  - name: Hub Scanning
    description: Scan physical packages onto their route rack at a hub.
    x-nash-topic: scheduling
  - name: Inventory
    description: Store inventory catalog sync to SFTP retail destinations (e.g. Uber).
    x-nash-topic: store_catalog
  - name: Optimization Activities
    description: Optimization runs launched from the portal or the API
    x-nash-topic: scheduling
  - name: Dispatch plans
    description: >-
      Draft dispatch plans: the orders and routes a dispatcher is planning
      before release.
    x-nash-topic: scheduling
  - name: Route Restrictions
    description: Org-scoped geographic areas the route optimizer must avoid traversing.
    x-nash-topic: config
  - name: Shifts
    description: Shifts
    x-nash-topic: provider
  - name: Users
    description: User, role, and organization-membership management.
    x-nash-topic: config
  - name: Vehicles
    description: Vehicles
    x-nash-topic: provider
  - name: Widgets
    description: >-
      Org configuration for embedded Nash Widgets: parent origins, enablement,
      and embed credentials.
    x-nash-topic: config
  - name: Conversation Agent
    description: >-
      Inbox conversation context and team-only whispers for Nash's conversation
      agent.
    x-nash-topic: internal
  - name: Provider Chat
    description: Carrier-chat context for a route, scoped to the caller's organization.
    x-nash-topic: internal
  - name: Order Ingestion
    description: >-
      Internal validate, commit, and reconciliation boundary for governed Order
      imports.
    x-nash-topic: internal
paths:
  /v1/contracts:
    get:
      tags:
        - Contracts
      summary: List Contracts
      description: >-
        List contracts visible to the authenticated organization. Returns a slim
        summary payload by default; pass include=details for the full record.
        Supports keyset pagination via the cursor returned in next_cursor.
      operationId: contracts_v1_list_contracts_route_get
      parameters:
        - name: active_only
          in: query
          required: false
          schema:
            title: Active Only
            type: boolean
            default: true
        - name: provider_id
          in: query
          required: false
          schema:
            title: Provider Id
            anyOf:
              - type: string
              - type: 'null'
            default: null
        - name: only_latest_version
          in: query
          required: false
          schema:
            title: Only Latest Version
            type: boolean
            default: true
        - name: include
          in: query
          required: false
          schema:
            title: Include
            enum:
              - summary
              - details
            type: string
            default: summary
        - name: limit
          in: query
          required: false
          schema:
            title: Limit
            maximum: 500
            minimum: 1
            type: integer
            default: 100
        - name: cursor
          in: query
          required: false
          schema:
            title: Cursor
            anyOf:
              - type: string
              - type: 'null'
            default: null
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListContractsResponse'
        '422':
          description: Unprocessable Content
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/NashValidationError'
components:
  schemas:
    ListContractsResponse:
      title: ListContractsResponse
      required:
        - contracts
      type: object
      properties:
        contracts:
          title: Contracts
          type: array
          items:
            $ref: '#/components/schemas/ContractReadDetailed'
        next_cursor:
          title: Next Cursor
          anyOf:
            - type: string
            - type: 'null'
          default: null
      description: >-
        Response body for ``GET /v1/contracts``.


        Items are typed as the wider ``ContractReadDetailed``. In summary mode
        the

        service nulls the detailed fields so summary callers get a uniform shape

        with the extra fields blanked.
    NashValidationError:
      title: NashValidationError
      required:
        - error
        - response_status
        - RequestID
      type: object
      properties:
        error:
          $ref: '#/components/schemas/NashErrorDetails'
        response_status:
          title: Response Status
          type: string
        RequestID:
          title: Requestid
          type: string
    ContractReadDetailed:
      title: ContractReadDetailed
      required:
        - contract_id
        - first_version_contract_id
        - display_name
        - is_active
        - currency
        - provider_id
        - created_at
      type: object
      properties:
        contract_id:
          title: Contract Id
          type: string
        first_version_contract_id:
          title: First Version Contract Id
          type: string
        next_version_contract_id:
          title: Next Version Contract Id
          anyOf:
            - type: string
            - type: 'null'
          default: null
        version:
          title: Version
          anyOf:
            - type: integer
            - type: 'null'
          default: null
        display_name:
          title: Display Name
          type: string
        is_active:
          title: Is Active
          type: boolean
        currency:
          title: Currency
          type: string
        provider_id:
          title: Provider Id
          type: string
        cancellation_binding_mode:
          title: Cancellation Binding Mode
          anyOf:
            - enum:
                - pinned
                - disabled
              type: string
            - type: 'null'
          default: null
        cancellation_policy_version_id:
          title: Cancellation Policy Version Id
          anyOf:
            - type: string
            - type: 'null'
          default: null
        provider_name:
          title: Provider Name
          anyOf:
            - type: string
            - type: 'null'
          default: null
        external_identifier:
          title: External Identifier
          anyOf:
            - type: string
            - type: 'null'
          default: null
        created_at:
          title: Created At
          type: string
          format: date-time
        delivery_price_type:
          title: Delivery Price Type
          anyOf:
            - type: string
            - type: 'null'
          default: null
        delivery_price:
          title: Delivery Price
          anyOf:
            - type: object
              additionalProperties: true
            - type: 'null'
          default: null
        eligibility_criteria:
          title: Eligibility Criteria
          anyOf:
            - type: object
              additionalProperties: true
            - type: 'null'
          default: null
        wait_fee:
          title: Wait Fee
          anyOf:
            - type: object
              additionalProperties: true
            - type: 'null'
          default: null
        cancellation_fee:
          title: Cancellation Fee
          anyOf:
            - type: object
              additionalProperties: true
            - type: 'null'
          default: null
        return_fee:
          title: Return Fee
          anyOf:
            - type: object
              additionalProperties: true
            - type: 'null'
          default: null
        insurance_price:
          title: Insurance Price
          anyOf:
            - type: object
              additionalProperties: true
            - type: 'null'
          default: null
        tip_amount:
          title: Tip Amount
          anyOf:
            - type: object
              additionalProperties: true
            - type: 'null'
          default: null
        toll_fee:
          title: Toll Fee
          anyOf:
            - type: object
              additionalProperties: true
            - type: 'null'
          default: null
        properties:
          title: Properties
          anyOf:
            - type: object
              additionalProperties: true
            - type: 'null'
          default: null
        has_enabled_vehicles:
          title: Has Enabled Vehicles
          anyOf:
            - type: boolean
            - type: 'null'
          description: >-
            Whether an enabled vehicle's first_version_contract_ids contains
            this contract's stored first_version_contract_id, matching the
            optimizer's Contract.vehicles relation. Computed from vehicle
            membership, independent of properties and vehicle ownership; null in
            summary mode.
          default: null
        supported_orgs:
          title: Supported Orgs
          anyOf:
            - type: array
              items:
                type: string
            - type: 'null'
          default: null
        excluded_orgs:
          title: Excluded Orgs
          anyOf:
            - type: array
              items:
                type: string
            - type: 'null'
          default: null
        prev_version_contract_id:
          title: Prev Version Contract Id
          anyOf:
            - type: string
            - type: 'null'
          default: null
        commit_message:
          title: Commit Message
          anyOf:
            - type: string
            - type: 'null'
          default: null
        created_by:
          title: Created By
          anyOf:
            - type: string
            - type: 'null'
          default: null
        delivery_price_function:
          title: Delivery Price Function
          anyOf:
            - type: string
            - type: 'null'
          default: null
        unassigned_driver_timeout_minutes:
          title: Unassigned Driver Timeout Minutes
          anyOf:
            - type: integer
            - type: 'null'
          default: null
      description: Full payload — populated when the caller asks for ``include=details``.
    NashErrorDetails:
      title: NashErrorDetails
      required:
        - code
        - message
      type: object
      properties:
        code:
          title: Code
          type: string
        message:
          title: Message
          type: string
        details:
          title: Details
          anyOf:
            - type: object
              additionalProperties: true
            - type: 'null'
          description: >-
            Structured error context; shape depends on `code`. For
            `VALIDATION_ERRORS` (HTTP 422) it is `{"fields": [{"loc": [...],
            "msg": "...", "type": "..."}]}` — one entry per invalid field, where
            `loc` is the field path, `msg` the human-readable message, and
            `type` the machine-readable error type (e.g. `string_type`,
            `missing`).
          default: null

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.