---
title: "Get contracts"
method: GET
path: "/api/v2/contracts"
tags: ["Contracts"]
---

# Get contracts

`GET /api/v2/contracts`

List contracts with optional filters and pagination.

## Query parameters

- `filter` union — Filter schema for `contract` list endpoints — pass a single condition or a logical group.
  - FilterContract — Filter parameters for listing contracts (recurring retainers). Supports filtering by template deal, start/end dates, interval, and next occurrence. Standard ID and date operators apply.
    - `id` union — Filter by contract ID.
      - Id — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `eq` Id — unresolved $ref
        - `contains` Id — unresolved $ref
        - `not_eq` Id — unresolved $ref
        - `not_contain` Id — unresolved $ref
    - `next_occurrence_on` union — Filter by next occurrence date range (`next_occurrence_on`).
      - NextOccurrenceOn — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `eq` NextOccurrenceOn — unresolved $ref
        - `not_eq` NextOccurrenceOn — unresolved $ref
        - `contains` NextOccurrenceOn — unresolved $ref
        - `not_contain` NextOccurrenceOn — unresolved $ref
    - `starts_on` union — Filter by contract start date range (`starts_on`).
      - object — Filter using explicit operator syntax.
        - `not_eq` StartsOn — unresolved $ref
        - `eq` StartsOn — unresolved $ref
        - `contains` StartsOn — unresolved $ref
        - `not_contain` StartsOn — unresolved $ref
      - StartsOn — unresolved $ref
    - `ends_on` union — Filter by contract end date range (`ends_on`).
      - EndsOn — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `contains` EndsOn — unresolved $ref
        - `not_eq` EndsOn — unresolved $ref
        - `not_contain` EndsOn — unresolved $ref
        - `eq` EndsOn — unresolved $ref
    - `contract_interval_id` union — Filter by the associated contract interval.
      - object — Filter using explicit operator syntax.
        - `eq` ContractIntervalId — unresolved $ref
        - `contains` ContractIntervalId — unresolved $ref
        - `not_contain` ContractIntervalId — unresolved $ref
        - `not_eq` ContractIntervalId — unresolved $ref
      - ContractIntervalId — unresolved $ref
  - object — A logical filter group — combine multiple conditions with the `$op` operator.
    - `$op` 'or' | 'and', required — Logical operator combining conditions in this group. `or` matches records satisfying any condition; `and` requires all conditions to match.
- `sort` string[]

## Headers

- `X-Organization-Id` string, required

## Response `200`

Collection contract

---

[API](https://skmtc.net/productive/apis/api-documentation.md) · [All operations](https://skmtc.net/productive/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/productive/api-documentation/revisions/7fff49576138/schema)