---
title: "List Contracts"
method: GET
path: "/v1/contracts"
tags: ["Contracts"]
---

# List Contracts

`GET /v1/contracts`

## Request

- Base URL: `https://api.sandbox.usenash.com`
- URL: `https://api.sandbox.usenash.com/v1/contracts`
- Auth: none declared

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.

## Query parameters

- `active_only` boolean
- `provider_id` string, nullable
- `only_latest_version` boolean
- `include` 'summary' | 'details'
- `limit` integer
- `cursor` string, nullable

## Response `200`

OK

- ListContractsResponse: 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.
  - `contracts` ContractReadDetailed[], required
    - `contract_id` string, required
    - `first_version_contract_id` string, required
    - `next_version_contract_id` string, nullable
    - `version` integer, nullable
    - `display_name` string, required
    - `is_active` boolean, required
    - `currency` string, required
    - `provider_id` string, required
    - `cancellation_binding_mode` 'pinned' | 'disabled', nullable
    - `cancellation_policy_version_id` string, nullable
    - `provider_name` string, nullable
    - `external_identifier` string, nullable
    - `created_at` string, date-time, required
    - `delivery_price_type` string, nullable
    - `delivery_price` object, nullable
    - `eligibility_criteria` object, nullable
    - `wait_fee` object, nullable
    - `cancellation_fee` object, nullable
    - `return_fee` object, nullable
    - `insurance_price` object, nullable
    - `tip_amount` object, nullable
    - `toll_fee` object, nullable
    - `properties` object, nullable
    - `has_enabled_vehicles` boolean, nullable: 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.
    - `supported_orgs` string[], nullable
    - `excluded_orgs` string[], nullable
    - `prev_version_contract_id` string, nullable
    - `commit_message` string, nullable
    - `created_by` string, nullable
    - `delivery_price_function` string, nullable
    - `unassigned_driver_timeout_minutes` integer, nullable
  - `next_cursor` string, nullable

## Other responses

- `422`: Unprocessable Content

---

[API](https://skmtc.dev/nash/apis/nash-api.md) - [All operations](https://skmtc.dev/nash/apis/nash-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nash/apis/nash-api/revisions/e3713837c5c9?raw)