---
title: "List contracts for current user"
method: GET
path: "/api/v1/documents/contracts"
tags: ["contracts"]
---

# List contracts for current user

`GET /api/v1/documents/contracts`

## Headers

- `x-api-key` string, nullable

## Response `200`

Successful Response

- ContractListResponse — List of contracts.
  - `contracts` ContractResponse[], required
    - `id` string, uuid, required
    - `clientId` string, uuid, required
    - `contractorId` string, uuid, required
    - `client` ContractParty — Minimal user data embedded in contract responses.
      - `id` string, uuid, required
      - `email` string, nullable
      - `displayName` string, nullable
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `entityName` string, nullable
      - `avatarUrl` string, nullable
      - `isBusiness` boolean
      - `address` object, nullable
    - `contractor` ContractParty — Minimal user data embedded in contract responses.
      - `id` string, uuid, required
      - `email` string, nullable
      - `displayName` string, nullable
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `entityName` string, nullable
      - `avatarUrl` string, nullable
      - `isBusiness` boolean
      - `address` object, nullable
    - `label` string, nullable
    - `documentId` string, uuid, nullable
    - `documentName` string, nullable
    - `documentFileName` string, nullable
    - `documentDownloadLink` string, nullable
    - `type` 'service' | 'employment' | 'nda' | 'contractor' | 'default_contractor' | 'custom' | 'vendor' | 'milestone' | 'msa' | 'other', required — Contract type.
    - `status` 'pending_approval_by_contractor' | 'pending_approval_by_client' | 'active' | 'completed' | 'cancelled' | 'paused', required — Contract status.
    - `amount` string, nullable
    - `currency` 'USD' | 'EUR' | 'GBP' | 'JPY' | 'CHF' | 'CAD' | 'AUD' | 'NZD' | 'SEK' | 'NOK' | 'AED' | 'HKD' — Supported invoice/contract currencies. G10 majors + AED/HKD.
    - `period` string, nullable
    - `activationAt` string, date-time, nullable
    - `expirationAt` string, date-time, nullable
    - `signatureRequestId` string, nullable
    - `signed` object, nullable
    - `clientAcceptance` object, nullable
    - `contractorAcceptance` object, nullable
    - `creatorId` string, uuid, nullable
    - `fields` object, nullable
    - `priorityMethods` TransactionType[]
    - `paymentMethods` object[]
    - `lastInvoice` ContractLastInvoice — Flat last invoice data embedded in contract responses.
      - `id` string, uuid, required
      - `clientId` string, uuid, required
      - `contractorId` string, uuid, nullable
      - `contractorEmail` string, nullable
      - `clientEmail` string, nullable
      - `contractId` string, uuid, nullable
      - `onchainTransactionId` string, nullable
      - `invoiceDocumentId` string, uuid, nullable
      - `amount` string, required
      - `discount` string, nullable
      - `currency` 'USD' | 'EUR' | 'GBP' | 'JPY' | 'CHF' | 'CAD' | 'AUD' | 'NZD' | 'SEK' | 'NOK' | 'AED' | 'HKD', required — Supported invoice/contract currencies. G10 majors + AED/HKD.
      - `comment` string, nullable
      - `emailMessage` string, nullable
      - `invoiceNumber` string, nullable
      - `issuedDate` string, date, nullable
      - `dueDate` string, date, nullable
      - `status` string, required
      - `paidAt` string, date-time, nullable
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/hevn-inc/apis/hevn-api.md) · [All operations](https://skmtc.net/hevn-inc/apis/hevn-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hevn-inc/hevn-api/versions/e6301d6796bf/schema)