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

# Job Status

> Poll the status of an async job and retrieve results when complete.

cost_units="credits" returns cost fields in credits (charge_credits, cost_credits)
instead of cents fields (charge_amount, cost_cents); the charge itself is unchanged.



## OpenAPI

````yaml https://api.sixtyfour.ai/openapi.json get /job-status/{job_id}
openapi: 3.1.0
info:
  title: Sixtyfour API
  description: >-
    Intelligence API for People and Entities. Deploy AI agents that investigate,
    resolve identities, map relationships, and surface risk signals
  contact:
    name: Sixtyfour
    url: https://sixtyfour.ai/
    email: support@sixtyfour.ai
  license:
    name: Proprietary
  version: 1.0.0
servers:
  - url: https://api.sixtyfour.ai
    description: Production
security: []
tags:
  - name: Enrichment
    description: Find and enrich emails, phones, and LinkedIn for people and companies.
  - name: org-chart
    description: Discover people inside a company and build org charts.
  - name: Search
    description: Run deep and filter searches over Sixtyfour's data.
  - name: Workflow
    description: Create, run, and manage enrichment workflows.
  - name: Workflow Schedules
    description: Create and manage recurring schedules for workflows.
  - name: Account
    description: Manage and inspect your account and credit balance.
  - name: Intelligence
    description: Verify identity attributes such as age using high-tier OSINT research.
  - name: Atlas
    description: >-
      Read your Atlas investigations: attribution graph, workspace files,
      reports, and exports.
paths:
  /job-status/{job_id}:
    get:
      tags:
        - Enrichment
      summary: Job Status
      description: >-
        Poll the status of an async job and retrieve results when complete.


        cost_units="credits" returns cost fields in credits (charge_credits,
        cost_credits)

        instead of cents fields (charge_amount, cost_cents); the charge itself
        is unchanged.
      operationId: job_status_job_status__job_id__get
      parameters:
        - name: job_id
          in: path
          required: true
          schema:
            type: string
            title: Job Id
        - name: cost_units
          in: query
          required: false
          schema:
            enum:
              - cents
              - credits
            type: string
            description: Response cost unit.
            default: cents
            title: Cost Units
          description: Response cost unit.
        - name: x-api-key
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Api-Key
      responses:
        '200':
          description: >-
            Current async job status. Completed enrichment jobs include the
            result under `result`.
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    required:
                      - status
                      - id
                      - run_id
                      - start_time
                    properties:
                      status:
                        type: string
                        enum:
                          - running
                          - failed
                          - cancelled
                          - terminated
                          - continued_as_new
                          - timed_out
                      id:
                        type: string
                      run_id:
                        type: string
                      start_time:
                        type: string
                        format: date-time
                      progress:
                        type: object
                        description: >-
                          Bulk runs only: rows enriched so far out of the total
                          rows submitted.
                        properties:
                          completed:
                            type: integer
                          total:
                            type: integer
                      investigation:
                        properties:
                          id:
                            type: string
                            title: Id
                            description: Atlas investigation ID.
                          workspace_url:
                            type: string
                            maxLength: 2083
                            minLength: 1
                            format: uri
                            title: Workspace Url
                            description: >-
                              Canonical Sixtyfour app URL for the
                              investigation's Atlas workspace.
                        type: object
                        required:
                          - id
                          - workspace_url
                        title: InvestigationReference
                        description: >-
                          Stable identity and app link carried across xhigh
                          lifecycle responses.


                          Live workspace statistics stay on the Atlas resource
                          endpoints so polling

                          a job never fans out into file, graph, or event count
                          queries.
                  - type: object
                    required:
                      - status
                      - id
                      - run_id
                      - start_time
                      - close_time
                      - result
                    properties:
                      status:
                        type: string
                        enum:
                          - completed
                      id:
                        type: string
                      run_id:
                        type: string
                      start_time:
                        type: string
                        format: date-time
                      close_time:
                        type: string
                        format: date-time
                      result:
                        description: Completed job result. Shape depends on task_type.
                        oneOf:
                          - properties:
                              structured_data:
                                additionalProperties: true
                                description: >-
                                  Requested enrichment fields and extracted
                                  values.
                                title: Structured Data
                                type: object
                              confidence_score:
                                anyOf:
                                  - type: number
                                  - type: 'null'
                                description: >-
                                  Overall confidence score for the enrichment
                                  result.
                                title: Confidence Score
                              references:
                                anyOf:
                                  - additionalProperties: true
                                    type: object
                                  - type: 'null'
                                description: Source references used to produce the result.
                                title: References
                              notes:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                                description: >-
                                  Human-readable notes about the enrichment
                                  result.
                                title: Notes
                              findings:
                                anyOf:
                                  - items: {}
                                    type: array
                                  - type: 'null'
                                description: >-
                                  Optional supporting findings produced by the
                                  enrichment agent.
                                title: Findings
                              field_confidence:
                                anyOf:
                                  - additionalProperties: true
                                    type: object
                                  - type: 'null'
                                description: >-
                                  Per requested field, nested like the request:
                                  its confidence (0-100), justification and
                                  sources. xHigh also names the research graph
                                  nodes the value rests on.
                                title: Field Confidence
                              investigation_id:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                                deprecated: true
                                description: >-
                                  Deprecated compatibility field. Use the
                                  response envelope's `investigation.id`.
                                title: Investigation Id
                            required:
                              - structured_data
                            title: EnrichmentJobResult
                            type: object
                          - type: object
                            description: >-
                              Object result for non-structured enrichment jobs,
                              including waterfall and single block jobs.
                            additionalProperties: true
                          - type: array
                            description: >-
                              Array result for jobs that return multiple rows or
                              records inline.
                            items:
                              additionalProperties: true
                              type: object
                      charge_amount:
                        type: number
                        description: Total cents charged when cost_units=cents.
                      charge_credits:
                        type: number
                        description: Total credits charged when cost_units=credits.
                      task_type:
                        type: string
                        example: lead_enrichment
                      investigation:
                        properties:
                          id:
                            type: string
                            title: Id
                            description: Atlas investigation ID.
                          workspace_url:
                            type: string
                            maxLength: 2083
                            minLength: 1
                            format: uri
                            title: Workspace Url
                            description: >-
                              Canonical Sixtyfour app URL for the
                              investigation's Atlas workspace.
                        type: object
                        required:
                          - id
                          - workspace_url
                        title: InvestigationReference
                        description: >-
                          Stable identity and app link carried across xhigh
                          lifecycle responses.


                          Live workspace statistics stay on the Atlas resource
                          endpoints so polling

                          a job never fans out into file, graph, or event count
                          queries.
                  - type: object
                    required:
                      - status
                      - id
                      - run_id
                      - start_time
                      - close_time
                      - results
                    properties:
                      status:
                        type: string
                        enum:
                          - completed
                      id:
                        type: string
                      run_id:
                        type: string
                      start_time:
                        type: string
                        format: date-time
                      close_time:
                        type: string
                        format: date-time
                      results:
                        type: array
                        items:
                          type: object
                          additionalProperties: true
                          properties:
                            filename:
                              type: string
                            download_url:
                              type: string
                      results_url:
                        type: string
                        format: uri
                        description: >-
                          The run in the Sixtyfour app, where a signed-in user
                          can download the full result files.
                      charge_amount:
                        type: number
                        description: Total cents charged when cost_units=cents.
                      charge_credits:
                        type: number
                        description: Total credits charged when cost_units=credits.
              examples:
                running:
                  summary: Running job
                  value:
                    status: running
                    id: job_123
                    run_id: temporal-run-123
                    start_time: '2026-06-10T00:00:00Z'
                running_xhigh:
                  summary: Running xhigh job with Atlas workspace
                  value:
                    status: running
                    id: job_123
                    run_id: temporal-run-123
                    start_time: '2026-06-10T00:00:00Z'
                    investigation:
                      id: 29beab70-42e4-5d19-b3b1-9a28279ca19f
                      workspace_url: >-
                        https://app.sixtyfour.ai/atlas/29beab70-42e4-5d19-b3b1-9a28279ca19f/graph
                running_bulk:
                  summary: Running bulk intelligence job
                  value:
                    status: running
                    id: job_123
                    run_id: temporal-run-123
                    start_time: '2026-06-10T00:00:00Z'
                    progress:
                      completed: 120
                      total: 500
                completed_enrichment:
                  summary: Completed enrichment job
                  value:
                    status: completed
                    id: job_123
                    run_id: temporal-run-123
                    start_time: '2026-06-10T00:00:00Z'
                    close_time: '2026-06-10T00:01:00Z'
                    result:
                      structured_data:
                        email: ada@example.com
                      confidence_score: 0.92
                      references:
                        https://example.com: Source page
                      notes: Found and verified requested information.
                    charge_amount: 5
                    task_type: lead_enrichment
                completed_xhigh_enrichment:
                  summary: Completed xhigh enrichment with Atlas workspace
                  value:
                    status: completed
                    id: job_123
                    run_id: temporal-run-123
                    start_time: '2026-06-10T00:00:00Z'
                    close_time: '2026-06-10T00:08:00Z'
                    result:
                      structured_data:
                        current_role: CEO
                      references:
                        https://example.com: Source page
                      notes: Completed deep research.
                    investigation:
                      id: 29beab70-42e4-5d19-b3b1-9a28279ca19f
                      workspace_url: >-
                        https://app.sixtyfour.ai/atlas/29beab70-42e4-5d19-b3b1-9a28279ca19f/graph
                    charge_amount: 50
                    task_type: lead_enrichment
                completed_enrichment_credits:
                  summary: Completed enrichment job with cost_units=credits
                  value:
                    status: completed
                    id: job_123
                    run_id: temporal-run-123
                    start_time: '2026-06-10T00:00:00Z'
                    close_time: '2026-06-10T00:01:00Z'
                    result:
                      structured_data:
                        email: ada@example.com
                      confidence_score: 0.92
                      references:
                        https://example.com: Source page
                      notes: Found and verified requested information.
                    charge_credits: 0.5
                    task_type: lead_enrichment
        '400':
          description: Request was rejected by the route's validation rules.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              example:
                detail: Invalid request body
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              example:
                detail: Invalid API key
        '402':
          description: >-
            Insufficient credits or no active subscription for this
            organization.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              example:
                detail: Insufficient API credits
        '403':
          description: Tier or feature not enabled for this organization.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              example:
                detail: >-
                  High tier company enrichment is not enabled for this org.
                  Contact sales to request access.
        '404':
          description: Async enrichment job not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              example:
                detail: Job not found
        '422':
          description: Request body failed validation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              example:
                detail: Rate limit exceeded
        '500':
          description: Unexpected server error. Retry with backoff.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              example:
                detail: Internal server error
        '503':
          description: >-
            The API key could not be checked, or the request could not be
            started, because a backing service is briefly unavailable. Nothing
            was charged. Retry after the `Retry-After` header.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
              example:
                detail: Could not verify the API key right now. Retry shortly.
components:
  schemas:
    HTTPValidationError:
      title: HTTPValidationError
      type: object
      properties:
        detail:
          type: array
          items:
            $ref: '#/components/schemas/ValidationError'
      example:
        detail:
          - loc:
              - body
              - target_company
              - domain
            msg: Field required
            type: missing
            input: null
            ctx: {}
    ValidationError:
      title: ValidationError
      type: object
      required:
        - loc
        - msg
        - type
      properties:
        loc:
          type: array
          items:
            oneOf:
              - type: string
              - type: integer
          description: Path to the field that failed validation.
          example:
            - body
            - target_company
            - domain
        msg:
          type: string
          description: Human-readable error message.
          example: Field required
        type:
          type: string
          description: Error code (e.g. 'missing', 'value_error').
          example: missing
        input:
          description: The offending input value (any type, may be null).
          nullable: true
          example: null
        ctx:
          type: object
          description: Optional error context.
          additionalProperties: true
          example: {}

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.