jobs

Job status, cumulative charge, funded-through (owner/admin)

Poll this after POST /api/v1/jobs. States run RESERVED -> STARTING -> RUNNING (verified ready; the meter starts here) -> STOPPING -> STOPPED -> CLEANING -> CLOSED, or FAILED / RECONCILING. GET /api/v1/jobs/{id}/access answers only while RUNNING (execution) or, for a limited window, after STOPPED (read-only retrieval); other states are 403.

get/api/v1/jobs/{id}

Request

  • Base URL: https://amplerun-api.spiry.org
  • URL: https://amplerun-api.spiry.org/api/v1/jobs/{id}
  • Auth: HTTP bearer

Path parameters

idstring uuid required
Example:3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40

Response

Job detail.

job_idstring uuid required
state'RESERVED' | 'STARTING' | 'RUNNING' | 'STOPPING' | 'STOPPED' | 'CLEANING' | 'CLOSED' | 'FAILED' | 'RECONCILING' required
cumulative_charge_microstring required

Unsigned base-10 integer as string; never a float.

funded_throughstring date-time required
budget_versionstring required

Unsigned base-10 integer as string; never a float.

machine_idstring uuid
fencestring

Unsigned base-10 integer as string; never a float.

rate_micro_per_hourstring

Unsigned base-10 integer as string; never a float.

accepted_runtime_msstring

Unsigned base-10 integer as string; never a float.

meter_started_atstring date-time
last_meter_receipt_atstring date-time
stopped_atstring date-time
tier'container' | 'inference'

Additive (D-23). The machine's tier; inference is community inference (don't send sensitive data).

gpu_modelstring

Additive. The GPU model the machine's agent reported (its manifest), for naming the deployment ("Qwen3 8B · RTX 4090"). Absent when the agent reported none. Display only, never billing input.

gpu_countinteger

Additive. How many of gpu_model the machine has, from the same manifest. Absent with gpu_model.

Example response

{
  "job_id": "7e8f9a0b-1c2d-4e3f-9a4b-5c6d7e8f9a0b",
  "state": "RUNNING",
  "cumulative_charge_micro": "112500",
  "funded_through": "2026-09-25T14:00:00Z",
  "budget_version": "1",
  "machine_id": "5d6e7f80-9a1b-4c2d-8e3f-4a5b6c7d8e9f",
  "fence": "4",
  "rate_micro_per_hour": "450000",
  "accepted_runtime_ms": "900000",
  "meter_started_at": "2026-09-25T12:02:10Z",
  "last_meter_receipt_at": "2026-09-25T12:17:10Z",
  "template": {
    "template_id": "pytorch-cuda",
    "name": "PyTorch (CUDA)",
    "kind": "classical"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.