Contracts
List 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
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"
}
]
}