---
title: "Poll an async-invocation job"
method: GET
path: "/jobs/{id}"
tags: ["jobs"]
---

# Poll an async-invocation job

`GET /jobs/{id}`

## Path parameters

- `id` string, uuid, required

## Response `200`

Current job status

- JobRecord
  - `id` string, uuid, required — Server-assigned job identifier (UUIDv4).
  - `function_id` string, uuid, required — Server-assigned function identifier (UUIDv4).
  - `status` 'pending' | 'completed' | 'failed', required — Lifecycle state of an async invocation. `pending` jobs have no result yet; `completed` and `failed` jobs carry a `result` payload (the InvokeResult shape and the ApiErrorBody shape, respectively).
  - `result` unknown
  - `created_unix_ms` integer, required

## Other responses

- `401` — Missing or unrecognised bearer token
- `404` — Function or job id is unknown
- `429` — Per-token QPS + burst exceeded. The `Retry-After` header carries the wait in integer seconds (RFC 9110 §10.2.3).

---

[API](https://skmtc.dev/craton-co/apis/tensorwasm-http-api.md) · [All operations](https://skmtc.dev/craton-co/apis/tensorwasm-http-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/craton-co/tensorwasm-http-api/revisions/d363e13d8640/schema)