Contracts

List contracts

get/v0/contracts

Query parameters

instance_typestring

Example:h100i

Filter by instance type

active_within_interval_startstring date-time

An ISO 8601 datetime string

Example:2025-07-11T20:41:37.423Z

Start of interval to find active contracts. Must be used with active_within_interval_end

active_within_interval_endstring date-time

An ISO 8601 datetime string

Example:2025-07-11T20:41:37.423Z

End of interval to find active contracts. Must be used with active_within_interval_start

statestring

Filter by contract state. Options: "All", "Upcoming", "Active", "Expired". Default excludes expired contracts

include_nodesboolean

Include contracts managed by the Nodes API

include_procurementsboolean

Include contracts associated with procurements

Response

List of contracts

object'list' required

has_moreboolean required

Example response

{
  "object": "list",
  "data": [
    {
      "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.1312

May 15, 2026b819ba3108b3124See the full diff
- ▲
  removed the required property details from the response with the 400 status
  response-required-property-removed
- ▲
  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 500 status
  response-required-property-removed
- ▲
  removed the required property message from the response with the 400 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 500 status
  response-required-property-removed
- ▲
  removed the required property type from the response with the 400 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 500 status
  response-required-property-removed
- ○
  added the required property error to the response with the 400 status
  response-required-property-added
- ○
  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 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, 202673ad90aa5d193See the full diff
- ○
  the data/items/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 data/items/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 data/items/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 data/items/zone response property oneOf list for the response status 200
  response-property-one-of-added
- ○
  removed market-api_ClusterName from the data/items/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, 2025505757215a254See the full diff
- ○
  added the new optional query request parameter include_nodes
  new-optional-request-parameter
- ○
  added the new optional query request parameter include_procurements
  new-optional-request-parameter
- ○
  added the optional property data/items/procurement_id to the response with the 200 status
  response-optional-property-added
- ○
  added the required property data/items/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