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

# List contracts

`GET /contracts`

## Request

- Base URL: `https://api.toriihq.com/v1.0`
- URL: `https://api.toriihq.com/v1.0/contracts`
- Auth: API key in header `Authorization`

Returns a list of contracts in the organization.<br/><br/><hr />This endpoint has two versions: 1.0 and 1.1. The default version is 1.0 for API keys created before Aug 1st 2026 and 1.1 for keys created after Aug 1st 2026. You can specify the version via the `X-API-Version` header to override.<hr /><br/><br/><h3>Filtering</h3><br/><br/>Filter contracts by passing each field as its own query parameter. Multiple filters are combined with AND. Values are matched by exact equality — partial match, range, and comparator operators are not supported on this endpoint.<br/><br/>Supported filter fields: `id`, `idApp`, `createdBy`, `status`, and any [custom contract field](https://app.toriihq.com/team/settings/contractDetails) system key.<br/><br/>Example:<br/><br/>```GET /contracts?fields=id,name,idApp,status,myCustomField&status=active&idApp=123&myCustomField=true```<br/><br/>The above returns contracts where `status=active` AND `idApp=123` AND `myCustomField=true`.<br/><br/><hr />Query params are different per version:<br/><br/><table><thead><tr><th>Query param</th><th>Supported in version</th><th>Description</th><th>Default value</th></tr></thead><tbody><tr><td>fields</td><td>v1.0, v1.1</td><td>List of fields to return for each contract</td><td>(no value)</td></tr><tr><td>q</td><td>v1.1 only</td><td>The query to search</td><td>(no value)</td></tr><tr><td>sort</td><td>v1.1 only</td><td>Sort order</td><td>(no value)</td></tr><tr><td>size</td><td>v1.1 only</td><td>Number of results to return (max: 1000)</td><td>1000</td></tr><tr><td>cursor</td><td>v1.1 only</td><td>Cursor for pagination</td><td>(no value)</td></tr><tr><td>aggs</td><td>v1.1 only</td><td>Aggregation configuration</td><td>(no value)</td></tr><tr><td>filters</td><td>v1.1 only</td><td>The filters to apply (JSON string)</td><td>(no value)</td></tr></tbody></table><br/><br/><h3>Multi-currency support</h3><br/><br/>All currency fields are returned in their original amounts based on the contract currency. To get the contract currency, add `currency` to `fields`.<br/><br/>Example:<br/><br/>```GET /contracts?fields=id,name,amount,currency```<br/><br/>
<p><ul><li>Rate limit: 100 requests per minute</li></ul></p>

## Query parameters

- `fields` string
- `q` string
- `sort` string
- `size` integer
- `cursor` string
- `aggs` string
- `filters` string

## Headers

- `x-api-version` '1.0' | '1.1'

## Response `200`

Contracts

- Model12: Contracts
  - `contracts` Contract[]
    - `id` integer: Unique identifier
    - `name` string
    - `status` string: Contract status
  - `aggregations` number
  - `count` integer: The number of results returned in this response
  - `total` integer: The total number of results
  - `nextCursor` string: A base64 string indicating the offset from which to start. <br>Pass the value of `nextCursor` returned from the previous call to get the next set of results

---

[API](https://skmtc.dev/toriihq/apis/torii-api-documentation.md) - [All operations](https://skmtc.dev/toriihq/apis/torii-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/toriihq/apis/torii-api-documentation/revisions/15fd1512591b?raw)