---
title: "Get AI list job status and results"
method: GET
path: "/v1/context/list/jobs/{job_id}"
tags: ["AI Lists"]
---

# Get AI list job status and results

`GET /v1/context/list/jobs/{job_id}`

## Request

- Base URL: `https://app.nex.ai/api/developers`
- URL: `https://app.nex.ai/api/developers/v1/context/list/jobs/{job_id}`
- Auth: API key in header `Authorization`

Get the status and results of an AI list generation job. Poll this endpoint until the job status is 'completed' or 'failed'.

## Path parameters

- `job_id` string, required

## Query parameters

- `include_attributes` boolean

## Response `200`

Job status and results (if completed)

- DeveloperGetAIListJobResponse
  - `message` object: Response wrapper
    - `job_id` string: The job identifier
    - `status` 'pending' | 'processing' | 'completed' | 'failed': Current job status
    - `created_at` string: ISO 8601 timestamp when job was created
    - `entities` object[]: Array of matched entities (only when status is 'completed')
      - `id` string: Entity identifier
      - `name` string: Entity primary attribute (contact name or company name)
      - `type` string: Entity type ('contact' or 'company')
      - `reason` string: LLM-generated explanation of why this entity matched
      - `highlights` string[]: Array of relevant insight snippets (up to 3)
      - `attributes` object: Object with all attribute values (if include_attributes was true)
    - `count` integer: Number of entities returned (only when status is 'completed')
    - `query_interpretation` string: AI-generated explanation of how the query was interpreted
    - `error` string: Error message (only when status is 'failed')

## Other responses

- `400`: Bad request - Invalid job ID
- `401`: Unauthorized - Invalid or missing API key
- `404`: Job not found
- `500`: Internal server error

## Changes

- **2026-02-17** `b05d8cb8cf43`: 1 info
  - api operation id `getAIListJob` was added
- **2025-11-28** `abb2dae0d348`: 8 warning, 1 info
  - removed the optional property `completed_at` from the response with the `200` status
  - removed the optional property `created_at` from the response with the `200` status
  - removed the optional property `error` from the response with the `200` status
  - removed the optional property `job_id` from the response with the `200` status
  - …5 more
- **2025-11-28** `cf119e071036`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nex/apis/nex-developer-api/changes/v1/context/list/jobs/:job_id/get.md)

---

[API](https://skmtc.dev/nex/apis/nex-developer-api.md) - [All operations](https://skmtc.dev/nex/apis/nex-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nex/apis/nex-developer-api/revisions/51003af13108?raw)