GET
Get Offer Status
Poll this endpoint after procurement to check instance readiness.

Procurement status values

StatusMeaning
availableOffer exists but not yet procured
provisioning_startedProcurement initiated, vendor provisioning in progress
provisioning_in_progressVendor is creating the instance
readyInstance is active — check instances array for connection details
failedProcurement failed — check failure_reason

Polling pattern

When procurement_status is ready, the instances array contains:
  • external_ip — Public IP address
  • ssh_command — Ready-to-use SSH command (e.g., ssh root@1.2.3.4)
  • status — Instance status (usually running)

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

offer_id
string<uuid>
required

Response

Successful Response

Status of an offer and its provisioned instances.

offer_id
string<uuid>
required

Unique offer identifier

status
string
required

Offer status: available, procured, failed, or expired

created_at
string<date-time>
required

When this offer was created

procurement_status
string | null

Procurement status: pending, provisioning, ready, or failed

instances
InstanceDetail · object[]

Provisioned instances (empty until procurement starts)

resources
OfferResourceInfo · object[]

Resources created by this offer

progress
string | null

Human-readable progress (e.g. '2/4 instances running')

failure_reason
string | null

Reason for failure (present when status=failed)

procured_at
string<date-time> | null

When this offer was procured (null if not yet procured)