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

# Get compounding job status

> Returns the current state of a compounding job triggered through the developer API. Poll this endpoint with the job_run_id returned by the trigger endpoint until the status changes from accepted or running to completed or failed.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/compounding/jobs/{job_run_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/compounding/jobs/{job_run_id}:
    get:
      tags:
        - Compounding
      summary: Get compounding job status
      description: >-
        Returns the current state of a compounding job triggered through the
        developer API. Poll this endpoint with the job_run_id returned by the
        trigger endpoint until the status changes from accepted or running to
        completed or failed.
      operationId: getCompoundingJobStatus
      parameters:
        - name: job_run_id
          in: path
          required: true
          description: The compounding job run identifier returned by the trigger endpoint
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Job status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/compounding.JobStatusResponse'
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/httpx.APIError'
        '404':
          description: Job 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:
    compounding.JobStatusResponse:
      type: object
      properties:
        job_run_id:
          type: string
          format: uuid
          description: Unique identifier for this compounding job
        job_type:
          type: string
          description: The compounding job type
          enum:
            - consolidation
            - pattern_detection
            - playbook_synthesis
            - decay_sweep
            - metrics
        workspace_id:
          type: integer
          description: Workspace ID the job belongs to
        status:
          type: string
          description: Current job status
          enum:
            - accepted
            - running
            - completed
            - failed
        dry_run:
          type: boolean
          description: Whether the job is running in dry-run mode
        insights_scanned:
          type: integer
          description: Total number of insights evaluated during the job
        insights_affected:
          type: integer
          description: Number of insights modified by the job
        candidates_created:
          type: integer
          description: Number of candidates or rules created by the job
        errors:
          type: integer
          description: Number of errors recorded during the job
        started_at:
          type: string
          format: date-time
          description: When the job entered the system
        completed_at:
          type: string
          format: date-time
          description: When the job completed, if it has finished
        duration_ms:
          type: integer
          description: Total job duration in milliseconds after completion
        error_details:
          type: object
          description: Structured error payload for failed jobs
          additionalProperties: true
    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

````