---
title: "List the caller's recent jobs (quota-free)."
method: GET
path: "/v1/jobs"
tags: ["self-serve"]
---

# List the caller's recent jobs (quota-free).

`GET /v1/jobs`

## Request

- Base URL: `https://api.mapmap.ai`
- URL: `https://api.mapmap.ai/v1/jobs`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `api_key`

## Query parameters

- `limit` integer

## Response `200`

The caller's jobs, newest first. Identity-scoped where the key has an identity, so a fleet rotating keys keeps sight of its own jobs

- JobListResponse: `GET /v1/jobs` response.
  - `jobs` JobRecord[], required: The caller's jobs, newest first.
    - `created_at` string, required: RFC 3339 UTC submission time.
    - `error` string, nullable: Why the job failed, once `status` is `failed`.
    - `finished_at` string, nullable: RFC 3339 UTC time the job finished, either way.
    - `id` string, required: Opaque job id (UUID v4), as returned by the submission.
    - `kind` string, required: `optimise` or `matrix`.
    - `refunded` boolean, required: Whether a failure refunded the submission's units and pence.
    - `result` unknown
    - `result_url` string, required: Where to fetch this job (and its result), the same URL the webhook carries.
    - `started_at` string, nullable: RFC 3339 UTC time a worker picked the job up.
    - `status` string, required: `queued`, `running`, `succeeded` or `failed`.
    - `units_charged` integer, required: Metered units the submission drew. Zero after a failure refund would be a lie, this is what was CHARGED, and `refunded` says whether it came back.
    - `webhook_status` string, nullable: `delivered` or `delivery_failed` once a webhook was attempted.

## Other responses

- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/mapmap/apis/sn-gateway.md) · [All operations](https://skmtc.dev/mapmap/apis/sn-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/mapmap/apis/sn-gateway/revisions/2293be8b4c38?raw)