Procurements
List procurements
⚠️ This endpoint is in public preview.
List all procurements.
get/preview/v2/procurements
Query parameters
workspacestring required
A resource path like 'sfc:workspace:acme:my-workspace' or an ID. Resource paths are human-readable but not stable - they change when resources are renamed or moved. IDs are stable and permanent.
Example:wksp_k3R-nX9vLm7Qp2Yw5Jd8F
Filter by workspace.
capacitystring
A resource path like 'sfc:capacity:acme:prod:my-capacity' or an ID. Resource paths are human-readable but not stable - they change when resources are renamed or moved. IDs are stable and permanent.
Example:cap_k3R-nX9vLm7Qp2Yw5Jd8F
limitinteger
starting_afterstring
Example:procc_gqXR7s0Kj5mHvE2wNpLc4Q
ending_beforestring
Example:procc_gqXR7s0Kj5mHvE2wNpLc4Q
Response
Paginated list of procurements.
Example response
{
"object": "list",
"cursor": "procc_gqXR7s0Kj5mHvE2wNpLc4Q",
"data": [
{
"id": "proc_k3R-nX9vLm7Qp2Yw5Jd8F",
"resource_path": "sfc:procurement:<account_id>:<workspace>:<name>",
"owner": "my-resource-name",
"workspace": "my-resource-name",
"name": "my-resource-name",
"object": "procurement",
"capacity": {
"id": "cap_k3R-nX9vLm7Qp2Yw5Jd8F",
"name": "my-resource-name"
},
"instance_sku": {
"id": "isku_k3R-nX9vLm7Qp2Yw5Jd8F",
"name": "my-resource-name"
},
"min_sell_price_dollars_per_node_hour": "2.500000",
"max_buy_price_dollars_per_node_hour": "2.500000",
"created_at": 1738972800,
"updated_at": 1738972800
}
]
}