---
title: "Get contract by ID"
method: GET
path: "/api/v1/documents/contracts/{contract_id}"
tags: ["contracts"]
---

# Get contract by ID

`GET /api/v1/documents/contracts/{contract_id}`

## Path parameters

- `contract_id` string, uuid, required

## Headers

- `x-api-key` string, nullable

## Response `200`

Successful Response

- ContractResponse — Contract response.
  - `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)