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

# Retrieve context artifact status and results

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



## OpenAPI

````yaml get /v1/context/artifacts/{artifact_id}
openapi: 3.0.0
info:
  description: >-
    REST API for accessing and managing your Nex data. Generate API keys from
    the Nex web UI and use them to authenticate requests.
  title: Nex Developer API
  contact: {}
  version: '1.0'
servers:
  - url: https://app.nex.ai/api/developers
security: []
paths:
  /v1/context/artifacts/{artifact_id}:
    get:
      tags:
        - Context
      summary: Retrieve context artifact status
      description: >-
        Retrieve the results of a previously submitted ProcessText request using
        the artifact ID returned from the POST /v1/context/text endpoint.
      operationId: getArtifact
      parameters:
        - description: Artifact ID returned from ProcessText
          name: artifact_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Artifact details with processing results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/developer.GetArtifactResponse'
        '400':
          description: Bad request - Invalid artifact ID
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/httpx.APIError'
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/httpx.APIError'
        '404':
          description: Artifact not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/httpx.APIError'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/httpx.APIError'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    developer.GetArtifactResponse:
      type: object
      properties:
        operation_id:
          type: integer
          description: Unique identifier for the processing operation
        status:
          type: string
          enum:
            - unknown
            - pending
            - processing
            - completed
            - failed
          description: Current operation status
        result:
          type: object
          description: Processing results (when status is 'completed')
          properties:
            entities_extracted:
              type: array
              items:
                type: object
                properties:
                  type:
                    type: string
                    description: Entity type (PERSON, COMPANY, ENGAGEMENT)
                  context_id:
                    type: integer
                    description: Internal context ID
                  canonical_entity_id:
                    type: integer
                    description: Entity ID (if linked)
                  properties:
                    type: object
                    description: Entity properties (name, email, job_title, domain, etc.)
                  previous_properties:
                    type: object
                    description: Properties before this operation (for updates)
                  is_new:
                    type: boolean
                    description: Whether entity was created in this operation
              description: Array of extracted entities with details
            entities_created:
              type: integer
              description: Number of new entities created
            entities_updated:
              type: integer
              description: Number of existing entities updated
            relationships_created:
              type: integer
              description: Number of relationships established
            insights_created:
              type: integer
              description: Number of insights generated
            tasks_suggested:
              type: integer
              description: Number of tasks suggested
        error:
          type: string
          description: Error message if status is 'failed'
        created_at:
          type: string
          description: Operation creation timestamp
        completed_at:
          type: string
          description: Operation completion timestamp
      example:
        operation_id: 48066188026052610
        status: completed
        created_at: '2025-11-28T14:14:40Z'
        completed_at: '2025-11-28T14:14:41Z'
        result:
          entities_extracted:
            - type: COMPANY
              context_id: 38485049540083710
              canonical_entity_id: 25339323448557880
              properties:
                name: Adobe
                domain: adobe.com
              previous_properties:
                name: Adobe
                domain: null
              is_new: false
            - type: PERSON
              context_id: 38485049540083710
              canonical_entity_id: 25339323448557884
              properties:
                name: John Smith
                email: john.smith@adobe.com
                job_title: Product Manager
              is_new: true
          entities_created: 1
          entities_updated: 1
          relationships_created: 1
          insights_created: 3
          tasks_suggested: 0
    httpx.APIError:
      type: object
      properties:
        code:
          type: integer
        message:
          type: string
  securitySchemes:
    ApiKeyAuth:
      description: 'API key for authentication (format: "Bearer YOUR_API_KEY")'
      type: apiKey
      name: Authorization
      in: header

````