Skip to content
Documentation menu
docs / api / get-v1-jobs
Optimisation and jobs

GET/v1/jobs

Access and price

AuthAn 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.
PriceNot 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

NameInTypeRequiredDescription
limitqueryintegernoHow 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
FieldTypeRequiredDescription
jobsJobRecord[]yesThe 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
    }
  ]
}
400limit is not a number

application/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