Contracts

Get contract

Get a contract

get/v0/contracts/{id}

Path parameters

idstring required

Example:cont_k3R-nX9vLm7Qp2Yw5Jd8F

Contract ID

Response

Contract details

object'contract' required

status'active' | 'pending' required

idstring required

created_atstring date-time required

An ISO 8601 datetime string

instance_typestring required

colocate_withMarketApiContractId[]

cluster_idstring

zonestring

state'Upcoming' | 'Active' | 'Expired' required

is_nodeboolean required

Specifies whether this contract is managed by the Nodes API

procurement_idstring nullable

The procurement which ordered this contract, if any

Example response

{
  "object": "contract",
  "id": "cont_k3R-nX9vLm7Qp2Yw5Jd8F",
  "created_at": "2025-07-11T20:41:37.423Z",
  "instance_type": "h100i",
  "shape": {
    "intervals": [
      "2025-07-11T20:41:37.423Z"
    ]
  },
  "colocate_with": [
    "cont_k3R-nX9vLm7Qp2Yw5Jd8F"
  ],
  "cluster_id": "clus_k3R-nX9vLm7Qp2Yw5Jd8F",
  "zone": "richmond",
  "is_node": true,
  "procurement_id": "proc_1234567890abcdef"
}

Changes

Changed in 4 of the 44 revisions of this API.13110

May 15, 2026b819ba3108b3124See the full diff
- ▲
  removed the required property details from the response with the 401 status
  response-required-property-removed
- ▲
  removed the required property details from the response with the 403 status
  response-required-property-removed
- ▲
  removed the required property details from the response with the 404 status
  response-required-property-removed
- ▲
  removed the required property details from the response with the 500 status
  response-required-property-removed
- ▲
  removed the required property message from the response with the 401 status
  response-required-property-removed
- ▲
  removed the required property message from the response with the 403 status
  response-required-property-removed
- ▲
  removed the required property message from the response with the 404 status
  response-required-property-removed
- ▲
  removed the required property message from the response with the 500 status
  response-required-property-removed
- ▲
  removed the required property type from the response with the 401 status
  response-required-property-removed
- ▲
  removed the required property type from the response with the 403 status
  response-required-property-removed
- ▲
  removed the required property type from the response with the 404 status
  response-required-property-removed
- ▲
  removed the required property type from the response with the 500 status
  response-required-property-removed
- ○
  added the required property error to the response with the 401 status
  response-required-property-added
- ○
  added the required property error to the response with the 403 status
  response-required-property-added
- ○
  added the required property error to the response with the 404 status
  response-required-property-added
- ○
  added the required property error to the response with the 500 status
  response-required-property-added
This revision also has 20 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 11, 202673ad90aa5d1913See the full diff
- ●
  changed the pattern of the path request parameter id from "cont"_[0-9a-zA-Z]+ to cont_[0-9a-zA-Z_-]{1,21}
  request-parameter-pattern-changed
- ○
  the cluster_id/oneOf[market-api_ClusterId]/ response's property pattern was changed from "clus"_[0-9a-zA-Z]+ to clus_[0-9a-zA-Z_-]{1,21} for the status 200
  response-property-pattern-changed
- ○
  the colocate_with/items/ response's property pattern was changed from "cont"_[0-9a-zA-Z]+ to cont_[0-9a-zA-Z_-]{1,21} for the status 200
  response-property-pattern-changed
- ○
  the id response's property pattern was changed from "cont"_[0-9a-zA-Z]+ to cont_[0-9a-zA-Z_-]{1,21} for the status 200
  response-property-pattern-changed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Dec 9, 202500ce4132845e11See the full diff
- ▲
  added market-api_ZoneName to the zone response property oneOf list for the response status 200
  response-property-one-of-added
- ○
  removed market-api_ClusterName from the zone response property oneOf list for the response status 200
  response-property-one-of-removed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Nov 7, 2025505757215a252See the full diff
- ○
  added the optional property procurement_id to the response with the 200 status
  response-optional-property-added
- ○
  added the required property is_node to the response with the 200 status
  response-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history