SFsfcompute
Contracts

List contracts

Changed on

List contracts

get/v0/contracts

Request

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

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

  • 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
    • 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