---
title: "Job status, cumulative charge, funded-through (owner/admin)"
method: GET
path: "/api/v1/jobs/{id}"
tags: ["jobs"]
---

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

`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

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.

## Path parameters

- `id` string, uuid, required

## Response `200`

Job detail.

- Job
  - `job_id` string, uuid, required
  - `state` 'RESERVED' | 'STARTING' | 'RUNNING' | 'STOPPING' | 'STOPPED' | 'CLEANING' | 'CLOSED' | 'FAILED' | 'RECONCILING', required
  - `cumulative_charge_micro` string, required: Unsigned base-10 integer as string; never a float.
  - `funded_through` string, date-time, required
  - `budget_version` string, required: Unsigned base-10 integer as string; never a float.
  - `machine_id` string, uuid
  - `fence` string: Unsigned base-10 integer as string; never a float.
  - `rate_micro_per_hour` string: Unsigned base-10 integer as string; never a float.
  - `accepted_runtime_ms` string: Unsigned base-10 integer as string; never a float.
  - `meter_started_at` string, date-time
  - `last_meter_receipt_at` string, date-time
  - `stopped_at` string, date-time
  - `tier` 'container' | 'inference': Additive (D-23). The machine's tier; inference is community inference (don't send sensitive data).
  - `gpu_model` string: 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_count` integer: Additive. How many of `gpu_model` the machine has, from the same manifest. Absent with gpu_model.
  - `template` object: Additive. Present only when the job's quote named a template (quotes.template_id); summary of templates.spec.
    - `template_id` string, required
    - `name` string, required
    - `kind` 'model' | 'classical' | 'custom', required

## Other responses

- `default`: Error envelope. 401 unauthenticated, 403/404 forbidden, 409 conflict, 422 invalid input, 429 rate limited (code UNAVAILABLE, retryable:true, no Retry-After header), 503 unavailable money/provider state with retryable:true.

---

[API](https://skmtc.dev/amplerun/apis/amplerun-business-api.md) · [All operations](https://skmtc.dev/amplerun/apis/amplerun-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/amplerun/apis/amplerun-business-api/revisions/40944687fa52?raw)