---
title: "Retrieve context artifact status"
method: GET
path: "/v1/context/artifacts/{artifact_id}"
tags: ["Context"]
---

# Retrieve context artifact status

`GET /v1/context/artifacts/{artifact_id}`

## Request

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

Retrieve the results of a previously submitted ProcessText request using the artifact ID returned from the POST /v1/context/text endpoint.

## Path parameters

- `artifact_id` string, required

## Response `200`

Artifact details with processing results

- DeveloperGetArtifactResponse
  - `operation_id` integer: Unique identifier for the processing operation
  - `status` 'unknown' | 'pending' | 'processing' | 'completed' | 'failed': Current operation status
  - `result` object: Processing results (when status is 'completed')
    - `entities_extracted` object[]: Array of extracted entities with details
      - `type` string: Entity type (PERSON, COMPANY, ENGAGEMENT)
      - `context_id` integer: Internal context ID
      - `canonical_entity_id` integer: Entity ID (if linked)
      - `properties` object: Entity properties (name, email, job_title, domain, etc.)
      - `previous_properties` object: Properties before this operation (for updates)
      - `is_new` boolean: Whether entity was created in this operation
    - `entities_created` integer: Number of new entities created
    - `entities_updated` integer: Number of existing entities updated
    - `relationships_created` integer: Number of relationships established
    - `insights_created` integer: Number of insights generated
    - `tasks_suggested` integer: Number of tasks suggested
  - `error` string: Error message if status is 'failed'
  - `created_at` string: Operation creation timestamp
  - `completed_at` string: Operation completion timestamp

## Other responses

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

## Changes

- **2026-02-17** `b05d8cb8cf43`: 1 info
  - api operation id `getArtifact` was added
- **2025-11-28** `9c0265d9fa05`: 1 warning, 1 info
  - removed the optional property `result/entities_processed` from the response with the `200` status
  - added the optional property `result/entities_updated` to the response with the `200` status
- **2025-11-28** `abb2dae0d348`: 3 warning, 2 info
  - removed the optional property `artifact_id` from the response with the `200` status
  - removed the optional property `results` from the response with the `200` status
  - added the new `unknown` enum value to the `status` response property for the response status `200`
  - added the optional property `operation_id` to the response with the `200` status
  - …1 more
- **2025-11-28** `cf119e071036`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nex/apis/nex-developer-api/changes/v1/context/artifacts/:artifact_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)