---
title: "Read one job (quota-free)."
method: GET
path: "/v1/jobs/{id}"
tags: ["self-serve"]
---

# Read one job (quota-free).

`GET /v1/jobs/{id}`

## Request

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

## Path parameters

- `id` string, required

## Response `200`

The job: `status`, and `result` inline once it is `succeeded`

- JobRecord: A job as the API reports it. `result` and `error` are mutually exclusive and both absent while the job is queued or running, a caller must never be handed a shape that looks like an empty answer when the real answer is "not yet".
  - `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
- `404`: No such job for this caller; including a job that belongs to somebody else, and one whose result has passed its retention TTL

---

[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)