---
title: "Get job status"
method: GET
path: "/jobs/{id}"
---

# Get job status

`GET /jobs/{id}`

## Request

- Base URL: `https://www.agentseo.dev/api/v1`
- URL: `https://www.agentseo.dev/api/v1/jobs/{id}`
- Auth: API key in header `x-api-key`

## Path parameters

- `id` string, required

## Response `200`

OK

- JobStatusEnvelope
  - `jobId` string
  - `status` 'queued' | 'processing' | 'retrying' | 'completed' | 'failed'
  - `phase` 'queued' | 'submitting_analysis' | 'waiting_analysis' | 'transforming' | 'finalizing'
  - `progress` object
    - `percent` number
    - `indeterminate` boolean
    - `eta_seconds` integer, nullable
  - `attempt` integer
  - `max_attempts` integer
  - `message` string
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable
  - `result` unknown
  - `error` object, nullable
    - `code` string
    - `message` string
    - `retryable` boolean
  - `context` JobContext
    - `project_id` string, nullable
    - `workflow_id` string, nullable
  - `poll_url` string
  - `events_url` string
  - `retry_after_seconds` integer

## Other responses

- `404`: Job not found

---

[API](https://skmtc.dev/agentseo/apis/agentseo-api.md) · [All operations](https://skmtc.dev/agentseo/apis/agentseo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentseo/apis/agentseo-api/revisions/53a62da6f92c?raw)