Documentation menu
Optimisation and jobs
GET/v1/jobs
Access and price
| Auth | An API key, as Authorization: Bearer snk_… or ?api_key=snk_…. Not metered: it draws no quota and no credit. Needs a full key; a browser (maps) key is refused. |
|---|---|
| Price | Not metered: no quota, no credit. |
What it does
List the caller's recent jobs (quota-free).
An API key, as Authorization: Bearer snk_… or ?api_key=snk_…. Not metered: it draws no quota and no credit.
Call it
bash
curl -fsS -X GET "https://api.mapmap.ai/v1/jobs" \
-H "Authorization: Bearer $MAPMAP_KEY"Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| limit | query | integer | no | How many jobs to return, 1-100 (default 20) |
Responses
200The caller's jobs, newest first. Identity-scoped where the key has an identity, so a fleet rotating keys keeps sight of its own jobs
| Field | Type | Required | Description |
|---|---|---|---|
| jobs | JobRecord[] | yes | The caller's jobs, newest first. |
Example: A response assembled from this schema's own field examples, enums, defaults and types; not a recorded call
json
{
"jobs": [
{
"created_at": "string",
"id": "string",
"kind": "string",
"refunded": false,
"result_url": "string",
"status": "string",
"units_charged": 0
}
]
}400
limit is not a numberapplication/problem+json · Problem
401Missing or invalid API key. Also: No key, or a missing, malformed, unknown, revoked or expired one (
unauthorized)application/problem+json · Problem
403A browser (
maps-scoped) key on a route that needs a full-scope key (scope-insufficient)application/problem+json · Problem
504The request did not finish within the gateway's request deadline (
request-timeout)application/problem+json · Problem
Error bodies follow the shared problem model documented on API conventions.
Also under Optimisation and jobs
Generated from https://api.mapmap.ai/openapi.json on 2026-11-12 · operationId list_jobs