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

# List contracts

`GET /contract/find`

## Request

- Base URL: `https://apisign.io/api`
- URL: `https://apisign.io/api/contract/find`
- Auth: API key in header `x-api-key`

List every contract in the organization, newest first, including test contracts. There are no filter or pagination parameters.

## Response `200`

List of contracts

- object
  - `contracts` ContractSummary[]
    - `id` string
    - `created_at` string, date-time
    - `name` string
    - `status` 'draft' | 'queued' | 'sent' | 'signed' | 'cancelled' | 'expired': `queued` is not set by any endpoint. `expired` is not currently set automatically: a contract past `expires_at` stays `sent`.
    - `test_mode` boolean

## Other responses

- `401`: Missing, invalid, expired or deleted API key. Body: `{ "error": "Unauthorized" }`
- `500`: Internal server error (also returned for a request body that is not valid JSON)

---

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