---
title: "List own jobs (renter owner/admin)"
method: GET
path: "/api/v1/jobs"
tags: ["jobs"]
---

# List own jobs (renter owner/admin)

`GET /api/v1/jobs`

## Request

- Base URL: `https://amplerun-api.spiry.org`
- URL: `https://amplerun-api.spiry.org/api/v1/jobs`
- Auth: HTTP bearer

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

Page of jobs.

- object
  - `items` Job[], required
    - `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
  - `next_cursor` string, nullable, 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)