> ## 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.

# Get Job

> The /v1 version of Job Status. Accepts IDs returned by versioned or unversioned routes. While queued or running, poll again after `next_poll_after` seconds. Stop polling when the status is `succeeded`, `failed`, or `canceled`.



## OpenAPI

````yaml /openapi.json get /v1/jobs/{job_id}
openapi: 3.1.0
info:
  title: Sixtyfour API
  description: >-
    Intelligence API for people and companies: research 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:
  - ApiKeyAuth: []
  - BearerAuth: []
tags:
  - name: Enrichment
    description: Find and enrich emails, phones, and LinkedIn for people and companies.
  - 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: Feedback
    description: >-
      Tell us a result was wrong, missing or outdated, and report problems with
      the API, the docs or a tool.
  - name: Intelligence
    description: Verify identity attributes such as age using high-tier OSINT research.
  - name: Atlas
    description: >-
      Start, continue and read Atlas investigations: attribution graph,
      workspace files, reports and exports.
paths:
  /v1/jobs/{job_id}:
    get:
      tags:
        - Jobs
      summary: Get Job
      description: >-
        The /v1 version of Job Status. Accepts IDs returned by versioned or
        unversioned routes. While queued or running, poll again after
        `next_poll_after` seconds. Stop polling when the status is `succeeded`,
        `failed`, or `canceled`.
      operationId: get_job_v1_jobs__job_id__get
      parameters:
        - name: job_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              Job identifier returned by a submit request. Pass it exactly as
              returned, including the `job_` prefix. IDs returned by unversioned
              endpoints are also accepted.
            examples:
              - job_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
            title: Job Id
          description: >-
            Job identifier returned by a submit request. Pass it exactly as
            returned, including the `job_` prefix. IDs returned by unversioned
            endpoints are also accepted.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Job'
              example:
                job_id: job_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                status: running
                created_at: '2026-11-03T18:04:12Z'
                next_poll_after: 5
          headers:
            Retry-After:
              schema:
                type: integer
              description: Seconds before polling again while running.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Unauthorized
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Payment Required
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Not Found
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobValidationError'
          description: Unprocessable Entity
        '429':
          headers:
            Retry-After:
              description: Seconds before retrying
              schema:
                type: string
                example: '1'
            X-RateLimit-Requests:
              description: Requests replenished per period
              schema:
                type: string
                example: '300'
            X-RateLimit-Period:
              description: Replenishment period in seconds
              schema:
                type: string
                example: '60'
            X-RateLimit-Burst:
              description: Maximum requests available after idling
              schema:
                type: string
                example: '15'
          x-rate-limit:
            requests: 300
            period_seconds: 60
            burst: 15
            scope: organization
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Too Many Requests
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Internal Server Error
        '503':
          headers:
            Retry-After:
              description: Seconds before retrying
              schema:
                type: string
                example: '15'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Service Unavailable
components:
  schemas:
    Job:
      properties:
        job_id:
          type: string
          title: Job Id
          description: >-
            Job identifier, normally prefixed with `job_`. Store it exactly as
            returned. GET /v1/jobs/{job_id} also accepts IDs returned by
            unversioned endpoints.
        status:
          type: string
          enum:
            - queued
            - running
            - succeeded
            - failed
            - canceled
          title: Status
          description: >-
            `queued`: accepted and waiting to start. `running`: work is in
            progress. `succeeded`: work finished successfully. `failed`: work
            ended with an error. `canceled`: work was canceled. The last three
            states are terminal; stop polling.
        created_at:
          type: string
          format: date-time
          title: Created At
          description: UTC timestamp when the job was created, in ISO 8601 format.
        next_poll_after:
          anyOf:
            - type: integer
            - type: 'null'
          title: Next Poll After
          description: >-
            Seconds before polling again while queued or running; omitted for
            terminal states.
        progress:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Progress
          description: >-
            Operation-specific progress while queued or running; omitted when
            unavailable.
        result:
          title: Result
          description: >-
            Successful output when available; bulk jobs may return download
            links.
        error:
          anyOf:
            - $ref: '#/components/schemas/JobError'
            - type: 'null'
          description: Failure details when available; omitted otherwise.
      type: object
      required:
        - job_id
        - status
        - created_at
      title: Job
      examples:
        - job_id: job_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
          status: running
          created_at: '2026-11-03T18:04:12Z'
          next_poll_after: 5
        - job_id: job_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
          status: succeeded
          created_at: '2026-11-03T18:04:12Z'
          result:
            structured_data:
              name: Saarth Shah
              title: CEO & Co-Founder
              company: Sixtyfour
              linkedin: https://www.linkedin.com/in/saarthshah
            notes: >-
              Confirmed current role from the LinkedIn profile and the company
              site.
            references:
              https://www.linkedin.com/in/saarthshah: LinkedIn profile with current title
            confidence_score: 9
    PublicJobError:
      properties:
        detail:
          type: string
          title: Detail
          description: Human-readable explanation of why the request failed.
        error_code:
          type: string
          title: Error Code
          description: >-
            Stable error code for handling the failure in code. Do not branch on
            the wording of `detail`.
        request_id:
          type: string
          title: Request Id
          description: >-
            Request identifier, equal to the X-Request-Id response header. Quote
            this value when contacting support.
        retryable:
          type: boolean
          title: Retryable
          description: >-
            If true, retrying the request can succeed without changing its
            inputs; respect Retry-After when present. If false, correct the
            request or resolve the reported condition before retrying.
        param:
          anyOf:
            - type: string
            - type: 'null'
          title: Param
          description: >-
            Dot-separated path to the parameter that caused the error, such as
            `body.lead` or `header.Idempotency-Key`. Null when the error is not
            tied to a parameter.
      type: object
      required:
        - detail
        - error_code
        - request_id
        - retryable
      title: PublicJobError
    PublicJobValidationError:
      properties:
        detail:
          type: string
          title: Detail
          description: Human-readable explanation of why the request failed.
        error_code:
          type: string
          title: Error Code
          description: >-
            Stable error code for handling the failure in code. Do not branch on
            the wording of `detail`.
        request_id:
          type: string
          title: Request Id
          description: >-
            Request identifier, equal to the X-Request-Id response header. Quote
            this value when contacting support.
        retryable:
          type: boolean
          title: Retryable
          description: >-
            If true, retrying the request can succeed without changing its
            inputs; respect Retry-After when present. If false, correct the
            request or resolve the reported condition before retrying.
        param:
          anyOf:
            - type: string
            - type: 'null'
          title: Param
          description: >-
            Dot-separated path to the parameter that caused the error, such as
            `body.lead` or `header.Idempotency-Key`. Null when the error is not
            tied to a parameter.
        errors:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Errors
          description: >-
            Individual validation failures, each with a parameter location
            (`loc`), message (`msg`), and error type (`type`).
      type: object
      required:
        - detail
        - error_code
        - request_id
        - retryable
        - errors
      title: PublicJobValidationError
    JobError:
      properties:
        error_code:
          type: string
          title: Error Code
          description: Stable error code for identifying the job failure in code.
        detail:
          type: string
          title: Detail
          description: Human-readable explanation of the job failure.
      type: object
      required:
        - error_code
        - detail
      title: JobError
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Sixtyfour API key.
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        An OAuth access token from `POST /oauth/token`, sent as `Authorization:
        Bearer <token>`. An API key sent as a bearer token is refused with 401.
        When both headers are sent, the bearer token is used.

````

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