curl --request GET \
--url https://app.nex.ai/api/developers/v1/context/list/jobs/{job_id} \
--header 'Authorization: <api-key>'{
"message": {
"job_id": "12345678901234567",
"status": "completed",
"created_at": "2024-01-15T10:30:00Z",
"count": 2,
"query_interpretation": "Finding all venture capital firms in the workspace",
"entities": [
{
"id": "32710180831586564",
"name": "Sequoia Capital",
"type": "company",
"reason": "Sequoia Capital is a well-known venture capital firm",
"highlights": [
"Invested in multiple portfolio companies",
"Active in Series A and B funding rounds"
],
"attributes": {
"domains": [
"sequoiacap.com"
],
"industries": [
"Venture Capital"
]
}
},
{
"id": "32710180831586565",
"name": "Andreessen Horowitz",
"type": "company",
"reason": "a16z is a prominent venture capital firm",
"highlights": [
"Focus on technology investments"
]
}
]
}
}Get the status and results of an AI list generation job. Poll this endpoint until the job status is ‘completed’ or ‘failed’.
curl --request GET \
--url https://app.nex.ai/api/developers/v1/context/list/jobs/{job_id} \
--header 'Authorization: <api-key>'{
"message": {
"job_id": "12345678901234567",
"status": "completed",
"created_at": "2024-01-15T10:30:00Z",
"count": 2,
"query_interpretation": "Finding all venture capital firms in the workspace",
"entities": [
{
"id": "32710180831586564",
"name": "Sequoia Capital",
"type": "company",
"reason": "Sequoia Capital is a well-known venture capital firm",
"highlights": [
"Invested in multiple portfolio companies",
"Active in Series A and B funding rounds"
],
"attributes": {
"domains": [
"sequoiacap.com"
],
"industries": [
"Venture Capital"
]
}
},
{
"id": "32710180831586565",
"name": "Andreessen Horowitz",
"type": "company",
"reason": "a16z is a prominent venture capital firm",
"highlights": [
"Focus on technology investments"
]
}
]
}
}API key for authentication (format: "Bearer YOUR_API_KEY")
Job ID returned from create job endpoint
Include full attributes for each record in the results
Job status and results (if completed)
Response wrapper
Show child attributes
The job identifier
Current job status
pending, processing, completed, failed ISO 8601 timestamp when job was created
Array of matched entities (only when status is 'completed')
Show child attributes
Entity identifier
Entity primary attribute (contact name or company name)
Entity type ('contact' or 'company')
LLM-generated explanation of why this entity matched
Array of relevant insight snippets (up to 3)
Object with all attribute values (if include_attributes was true)
Number of entities returned (only when status is 'completed')
AI-generated explanation of how the query was interpreted
Error message (only when status is 'failed')