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

# Poll an async job

`GET /api/v1/jobs/{id}`

## Request

- Base URL: `https://mitosislabs.ai`
- URL: `https://mitosislabs.ai/api/v1/jobs/{id}`
- Auth: none required

## Path parameters

- `id` string, required

## Response `200`

Job state (poll until status=completed)

- Job
  - `id` string, required
  - `type` string, required
  - `status` 'pending' | 'running' | 'completed', required
  - `createdAt` string, date-time, required
  - `location` string, uri
  - `result` object, nullable: Present when status=completed
    - `site` string
    - `plans` integer
    - `skills` integer
    - `generatedAt` string, date-time

## Other responses

- `400`: Malformed request
- `404`: Not found
- `429`: Rate limit exceeded. Retry after X-RateLimit-Reset seconds

---

[API](https://skmtc.dev/mitosislabs/apis/mitosis-public-api.md) · [All operations](https://skmtc.dev/mitosislabs/apis/mitosis-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mitosislabs/apis/mitosis-public-api/revisions/c82bbc6785c1?raw)