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

# Get Job Status

> Returns the current state of an asynchronous job such as a customer batch import.

# Retrieving a Job Status

This endpoint allows you to retrieve the status of a job.

## Path Parameters

| Parameter | Type          | Description                                           |
| --------- | ------------- | ----------------------------------------------------- |
| id        | string (UUID) | The unique identifier of the job you want to retrieve |

## Response Structure

The response includes comprehensive details about the job, including:

* Basic job details (ID, name, status)
* Timing information (createdAt, updatedAt)
* Job provider information
* Workspace association
* Error details (if applicable)

The response object includes the following fields:

| Field         | Type              | Description                                                                        |
| ------------- | ----------------- | ---------------------------------------------------------------------------------- |
| id            | string (UUID)     | The unique identifier of the job                                                   |
| createdAt     | string (ISO date) | The timestamp when the job was created                                             |
| updatedAt     | string (ISO date) | The timestamp when the job was last updated                                        |
| jobProviderId | string (UUID)     | The identifier of the job provider that processed this job                         |
| name          | string            | The name of the job                                                                |
| status        | string            | The current status of the job (created, queued, active, success, failed, retrying) |
| error         | string or null    | Error message if the job failed, null otherwise                                    |
| workspaceId   | string (UUID)     | The identifier of the workspace this job belongs to                                |


## OpenAPI

````yaml GET /jobs/{id}
openapi: 3.1.0
info:
  title: Oration AI Webhooks
  description: >-
    Webhook events for Oration AI platform - AI agents, conversations, and voice
    interactions
  version: 1.0.0
  contact:
    name: Oration AI Support
    url: https://oration.ai/support
    email: support@oration.ai
servers:
  - url: https://www.oration.ai/api/v2
    description: Production API base URL
security: []
tags:
  - name: conversations
    description: Create conversations and inspect conversation records.
  - name: customers
    description: >-
      Bulk import and manage customer records used by campaigns and outbound
      workflows.
  - name: jobs
    description: >-
      Track asynchronous jobs created by long-running import or processing
      requests.
externalDocs:
  description: Product and integration documentation
  url: https://docs.oration.ai
paths:
  /jobs/{id}:
    get:
      tags:
        - jobs
      summary: Get job status by ID
      description: >-
        Returns the current state of an asynchronous job such as a customer
        batch import.
      operationId: lambda-workspaces-job-getById
      parameters:
        - in: path
          name: id
          description: Job UUID returned by an async endpoint such as `/customers/batch`.
          example: 5135bfe3-b2c7-41f3-a44f-f4b58e7384df
          schema:
            type: string
          required: true
        - in: header
          name: x-api-key
          description: Workspace API key used for server-to-server authentication.
          example: ora_live_xxxxxxxxxxxxx
          schema:
            type: string
          required: true
        - in: header
          name: x-workspace-slug
          description: Workspace slug associated with the job.
          example: acme-support
          schema:
            type: string
          required: true
        - in: header
          name: x-workspace-id
          description: Workspace UUID. Useful when the workspace slug is not available.
          example: 6f8c7d9d-34e2-4f42-9f5d-8f3c5b16a6af
          schema:
            type: string
      responses:
        '200':
          description: Job status returned successfully.
          content:
            application/json:
              schema:
                type: object
                description: Current status of an asynchronous job.
                properties:
                  id:
                    type: string
                    description: Job identifier.
                    format: uuid
                  createdAt:
                    type: string
                    description: Timestamp when the job was created.
                  updatedAt:
                    type: string
                    description: Timestamp when the job status last changed.
                  jobProviderId:
                    type: string
                    description: >-
                      Identifier used by the underlying job provider or queue
                      backend.
                    format: uuid
                  name:
                    type: string
                    description: Internal job name for the asynchronous task.
                  status:
                    type: string
                    description: Current execution state of the job.
                    enum:
                      - created
                      - queued
                      - active
                      - success
                      - failed
                      - retrying
                  error:
                    type: string
                    description: Error message when the job fails; otherwise null.
                    nullable: true
                  workspaceId:
                    type: string
                    description: Workspace that owns the job.
                    format: uuid
                required:
                  - id
                  - createdAt
                  - updatedAt
                  - jobProviderId
                  - name
                  - status
                  - error
                  - workspaceId
              examples:
                completedJob:
                  summary: Finished import job
                  value:
                    id: 5135bfe3-b2c7-41f3-a44f-f4b58e7384df
                    createdAt: '2026-04-01T10:16:00.000Z'
                    updatedAt: '2026-04-01T10:18:42.000Z'
                    jobProviderId: b9eb98d0-2445-46a3-8107-4fcf243f85e4
                    name: customer.createBatch
                    status: success
                    error: null
                    workspaceId: 6f8c7d9d-34e2-4f42-9f5d-8f3c5b16a6af
        '400':
          description: Invalid input data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.BAD_REQUEST'
        '401':
          description: Authorization not provided
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.UNAUTHORIZED'
        '403':
          description: Insufficient access
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.FORBIDDEN'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.NOT_FOUND'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.INTERNAL_SERVER_ERROR'
      security:
        - Authorization: []
components:
  schemas:
    error.BAD_REQUEST:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Invalid input data
        code:
          type: string
          description: The error code
          example: BAD_REQUEST
        issues:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
          description: An array of issues that were responsible for the error
          example: []
      required:
        - message
        - code
      title: Invalid input data error (400)
      description: The error information
      example:
        code: BAD_REQUEST
        message: Invalid input data
        issues: []
    error.UNAUTHORIZED:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Authorization not provided
        code:
          type: string
          description: The error code
          example: UNAUTHORIZED
        issues:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
          description: An array of issues that were responsible for the error
          example: []
      required:
        - message
        - code
      title: Authorization not provided error (401)
      description: The error information
      example:
        code: UNAUTHORIZED
        message: Authorization not provided
        issues: []
    error.FORBIDDEN:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Insufficient access
        code:
          type: string
          description: The error code
          example: FORBIDDEN
        issues:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
          description: An array of issues that were responsible for the error
          example: []
      required:
        - message
        - code
      title: Insufficient access error (403)
      description: The error information
      example:
        code: FORBIDDEN
        message: Insufficient access
        issues: []
    error.NOT_FOUND:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Not found
        code:
          type: string
          description: The error code
          example: NOT_FOUND
        issues:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
          description: An array of issues that were responsible for the error
          example: []
      required:
        - message
        - code
      title: Not found error (404)
      description: The error information
      example:
        code: NOT_FOUND
        message: Not found
        issues: []
    error.INTERNAL_SERVER_ERROR:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Internal server error
        code:
          type: string
          description: The error code
          example: INTERNAL_SERVER_ERROR
        issues:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
          description: An array of issues that were responsible for the error
          example: []
      required:
        - message
        - code
      title: Internal server error error (500)
      description: The error information
      example:
        code: INTERNAL_SERVER_ERROR
        message: Internal server error
        issues: []
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Bearer token issued for an authenticated Oration user or service
        account.

````