SFsfcompute
Contracts

Get contract

Changed on

Get a contract

get/v0/contracts/{id}

Request

  • The document declares no server URL.
  • Auth
    HTTP bearer

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

  • b819ba3108b3Revision changes
    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 73ad90aa5d19Revision changes
    • warning

      changed the pattern of the path request parameter id from "cont"_[0-9a-zA-Z]+ to cont_[0-9a-zA-Z_-]{1,21}

    • info

      the //// response's property pattern was changed from "clus"_[0-9a-zA-Z]+ to clus_[0-9a-zA-Z_-]{1,21} for the status

    • info

      the / response's property pattern was changed from "cont"_[0-9a-zA-Z]+ to cont_[0-9a-zA-Z_-]{1,21} for the status

    • info

      the response's property pattern was changed from "cont"_[0-9a-zA-Z]+ to cont_[0-9a-zA-Z_-]{1,21} for the status