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

# Get Job Status

> Check the status of a running or completed enrich job

## Path Parameters

<ParamField path="jobId" type="string" required>
  The job ID returned from `POST /api/enrich`. Starts with `run_`
</ParamField>

## Request

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.cheetah-sales.dev/api/enrich/run_cm5x8k9j0000108l4g2h5h3k2 \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const jobId = 'run_cm5x8k9j0000108l4g2h5h3k2';

  const response = await fetch(`https://api.cheetah-sales.dev/api/enrich/${jobId}`, {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  });

  const data = await response.json();
  console.log(data.status); // EXECUTING, COMPLETED, or FAILED
  ```

  ```python Python theme={null}
  import requests

  job_id = 'run_cm5x8k9j0000108l4g2h5h3k2'

  response = requests.get(
      f'https://api.cheetah-sales.dev/api/enrich/{job_id}',
      headers={'Authorization': 'Bearer YOUR_API_KEY'}
  )
  print(response.json()['status'])
  ```
</CodeGroup>

## Response

<ResponseField name="success" type="boolean">
  Whether the request was successful
</ResponseField>

<ResponseField name="jobId" type="string">
  The job ID
</ResponseField>

<ResponseField name="status" type="string">
  Job status: `QUEUED`, `EXECUTING`, `COMPLETED`, or `FAILED`
</ResponseField>

<ResponseField name="totalLeads" type="number">
  Number of leads (when completed)
</ResponseField>

<ResponseField name="leadsUrl" type="string">
  URL to fetch leads (when completed)
</ResponseField>

<Tabs>
  <Tab title="Executing">
    ```json theme={null}
    {
      "success": true,
      "jobId": "run_cm5x8k9j0000108l4g2h5h3k2",
      "status": "EXECUTING",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "startedAt": "2024-01-15T10:30:05.000Z"
    }
    ```
  </Tab>

  <Tab title="Completed">
    ```json theme={null}
    {
      "success": true,
      "jobId": "run_cm5x8k9j0000108l4g2h5h3k2",
      "status": "COMPLETED",
      "totalLeads": 25,
      "leadsUrl": "/api/enrich/run_cm5x8k9j0000108l4g2h5h3k2/leads",
      "finishedAt": "2024-01-15T10:35:00.000Z"
    }
    ```
  </Tab>

  <Tab title="Failed">
    ```json theme={null}
    {
      "success": true,
      "jobId": "run_cm5x8k9j0000108l4g2h5h3k2",
      "status": "FAILED",
      "error": {
        "message": "Invalid Sales Navigator URL"
      }
    }
    ```
  </Tab>
</Tabs>