> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tapkit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get job

> Check the status of an action

Poll a job started with `?async=true`. See [Jobs](/api-reference/introduction#jobs).

<ParamField path="job_id" type="string" required>
  The `job_id` returned by the action.
</ParamField>

## Response

<ResponseField name="id" type="string">
  The job's ID.
</ResponseField>

<ResponseField name="status" type="string">
  `pending`, `running`, `completed`, or `failed`.
</ResponseField>

<ResponseField name="result" type="object | null">
  On failure, `error` describes what went wrong.
</ResponseField>

<ResponseField name="created_at" type="string">
  When the job was created.
</ResponseField>

<ResponseField name="completed_at" type="string | null">
  When the job finished.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.tapkit.ai/v1/jobs/$JOB_ID \
    -H "X-API-Key: $TAPKIT_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "5d2c9a0e-7f7b-4c1e-9d1a-2f4b8e0c3a61",
    "status": "failed",
    "result": { "error": "TIMEOUT" },
    "created_at": "2026-09-23T18:30:00Z",
    "completed_at": "2026-09-23T18:31:00Z"
  }
  ```
</ResponseExample>