API reference · Jobs

A job

A run’s status and, once it is done, its result. Pass wait (up to 30 seconds) to be answered as soon as it finishes rather than at once.

GET/api/v1/jobs/{id}

Costs: Free
MCP tool: get_job
Answers: At once (200)

curl "https://appleak.app/api/v1/jobs/6f1c2b9e-1d0a-4c55-9a51-2b7f0c3e8d41?wait=30" \
  -H "Authorization: Bearer $APPLEAK_KEY"

Response200 OK

{
  "id": "6f1c2b9e-1d0a-4c55-9a51-2b7f0c3e8d41",
  "object": "job",
  "kind": "report",
  "status": "done",
  "credits": 10,
  "refunded": false,
  "progress": null,
  "createdAt": "2026-10-19T12:00:00.000Z",
  "startedAt": null,
  "finishedAt": null,
  "error": null,
  "result": {
    "reportId": "b3c1e0aa-…",
    "report": {
      "spec": {
        "question": "meditation apps"
      },
      "apps": []
    }
  },
  "links": {
    "self": "/api/v1/jobs/6f1c2b9e-1d0a-4c55-9a51-2b7f0c3e8d41"
  }
}

#Parameters

Path parameters

iduuidrequired

Query parameters

waitintegeroptionaldefault 0
Seconds to wait for the run to finish before answering. 0–30

#Returns

The answer as JSON, beside. Free, and does not count against your credits.

MCP: get_job — Read an Appleak job started by a start_* tool: its status (queued, running, done, failed, cancelled), credits charged, and the result once done. Pass wait (seconds, up to 30) to wait for it. Free.