---
title: "Get a contract type"
method: GET
path: "/contract-types/{id}"
tags: ["Contract Types"]
---

# Get a contract type

`GET /contract-types/{id}`

## Request

- Base URL: `https://contracko.com/api/v1`
- URL: `https://contracko.com/api/v1/contract-types/{id}`
- Auth: one of:
  - API key in header `x-contracko-api-key`
  - HTTP bearer

Returns a single contract type scoped to the API key organisation.

## Path parameters

- `id` string, uuid, required: Contract type UUID

## Response `200`

Contract type returned.

- object
  - `contractType` object, required: Contract type stored in Contracko
    - `id` string, uuid, required
    - `name` string, required
    - `description` string, nullable, required
    - `organisationId` string, required
    - `isDefault` boolean, required
    - `source` 'manual' | 'template_adoption' | 'starting_template' | 'ai_generated', required
    - `sourceTemplateId` string, uuid, nullable, required
    - `sourceTemplateSlug` string, nullable, required
    - `entityStatus` 'pending-review' | 'archived', nullable, required: Read-only review state. AI-created types can be pending-review; any update clears it to null.
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `fields` object[], required: Custom fields of this contract type
      - `id` string, uuid, required
      - `name` string, required
      - `fieldKey` string, required
      - `description` string, nullable, required
      - `placeholder` string, nullable, required
      - `fieldType` 'text' | 'number' | 'date' | 'boolean' | 'currency' | 'percentage' | 'select' | 'multi_select', required
      - `required` boolean, required
      - `config` union, required
        - string
        - number
        - boolean
        - object
        - unknown[]
          - unknown
      - `defaultValue` union, required
        - string
        - number
        - boolean
        - object
        - unknown[]
          - unknown
      - `displayOrder` integer, required
      - `categoryId` string, uuid, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required

## Other responses

- `400`: Request validation failed (payload, query, or path format is invalid).
- `401`: Authentication failed (missing, invalid, revoked, or expired API key).
- `403`: Access denied because the API key does not include the required access for this operation.
- `404`: The requested resource was not found.
- `429`: Retry later because the request rate limit was reached.
- `500`: The server could not complete the request.

---

[API](https://skmtc.dev/contracko/apis/contracko-parsing-api.md) · [All operations](https://skmtc.dev/contracko/apis/contracko-parsing-api/llms.txt) · [OpenAPI document](https://skmtc.dev/contracko/apis/contracko-parsing-api/revisions/2f90b1d3cafd?raw)