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

# Get Job Detail

> Get detailed job information including input, output, error, ML runtime info, and billing details.



## OpenAPI

````yaml /openapi.json get /jobs/{job_id}
openapi: 3.1.0
info:
  title: Woodwide API
  description: API service for the Woodwide platform
  version: 0.1.0
servers:
  - url: https://api.woodwide.ai
    description: Production
security: []
paths:
  /jobs/{job_id}:
    get:
      tags:
        - Jobs
      summary: Get Job Detail
      description: >-
        Get detailed job information including input, output, error, ML runtime
        info, and billing details.
      operationId: get_job_jobs__job_id__get
      parameters:
        - name: job_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Job Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobDetail'
              example:
                job_id: c3d4e5f6-0000-0000-0000-000000000003
                type: train
                status: succeeded
                created_at: '2025-01-15T10:00:00Z'
                started_at: '2025-01-15T10:00:05Z'
                finished_at: '2025-01-15T10:05:30Z'
                progress: 100
                woodwide_runtime_version: '0.1'
                credits_consumed: 12.5
        '401':
          description: Unauthorized -- API key is missing or invalid.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    example: Not authenticated
        '403':
          description: >-
            Forbidden -- your API key does not have permission for this
            resource.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    example: Forbidden
        '404':
          description: Not Found -- the requested resource does not exist.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    example: Not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '429':
          description: >-
            Too Many Requests -- you have exceeded the rate limit. Heavy
            operations (training, inference, dataset uploads) are limited to 60
            requests per minute per API key. All other endpoints are limited to
            600 requests per minute per API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    example: Rate limit exceeded. Retry after a short delay.
      security:
        - HTTPBearer: []
components:
  schemas:
    JobDetail:
      properties:
        job_id:
          type: string
          format: uuid
          title: Job Id
        type:
          type: string
          title: Type
          description: 'Job type: dataset_ingest, train, infer_sync, or infer_batch.'
        status:
          $ref: '#/components/schemas/JobStatus'
          description: >-
            Job status: initializing, pending, queued, running, succeeded,
            failed, canceled, or rejected. For dataset_ingest jobs, may also be
            'waiting_for_upload'.
        created_at:
          type: string
          format: date-time
          title: Created At
        started_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Started At
        finished_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Finished At
        created_by:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Created By
          description: 'Who created this job: {principal_type, user_id, api_key_id}.'
        input:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Input
        output:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Output
        resources:
          anyOf:
            - $ref: '#/components/schemas/IngestResources'
            - $ref: '#/components/schemas/TrainResources'
            - $ref: '#/components/schemas/InferSyncResources'
            - $ref: '#/components/schemas/InferBatchResources'
            - type: 'null'
          title: Resources
          description: Typed resource references for this job.
        error_message:
          anyOf:
            - type: string
            - type: 'null'
          title: Error Message
          description: Human-readable error message if the job failed.
        woodwide_runtime_version:
          anyOf:
            - type: string
            - type: 'null'
          title: Woodwide Runtime Version
          description: ML runtime version used for this job.
        credits_consumed:
          anyOf:
            - type: number
            - type: 'null'
          title: Credits Consumed
          description: Credits consumed by this job (null if not yet finalized).
        progress:
          anyOf:
            - type: number
            - type: 'null'
          title: Progress
          description: >-
            Progress percentage (0-100). For training jobs, tracks training
            progress.
        estimated_seconds_remaining:
          anyOf:
            - type: number
            - type: 'null'
          title: Estimated Seconds Remaining
          description: >-
            Estimated wall-clock seconds until the job completes (training jobs
            only).
      type: object
      required:
        - job_id
        - type
        - status
        - created_at
      title: JobDetail
      description: |-
        Detailed job information.

        Extends ``Job`` with input/output payloads, typed resource
        references, error details, and billing information.
      example:
        job_id: c3d4e5f6-0000-0000-0000-000000000003
        type: train
        status: succeeded
        created_at: '2025-01-15T10:00:00Z'
        started_at: '2025-01-15T10:00:05Z'
        finished_at: '2025-01-15T10:05:30Z'
        progress: 100
        woodwide_runtime_version: 0.1.0
        credits_consumed: 12.5
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
      description: Returned when request parameters or body fail validation.
    JobStatus:
      type: string
      enum:
        - initializing
        - pending
        - queued
        - running
        - succeeded
        - failed
        - canceled
        - rejected
        - waiting_for_upload
      title: JobStatus
    IngestResources:
      properties:
        type:
          type: string
          const: dataset_ingest
          title: Type
          default: dataset_ingest
        dataset:
          $ref: '#/components/schemas/DatasetVersionRef'
      type: object
      required:
        - dataset
      title: IngestResources
      description: Resources for a dataset_ingest job.
    TrainResources:
      properties:
        type:
          type: string
          const: train
          title: Type
          default: train
        model:
          $ref: '#/components/schemas/ModelVersionRef'
        dataset:
          $ref: '#/components/schemas/DatasetVersionRef'
      type: object
      required:
        - model
        - dataset
      title: TrainResources
      description: Resources for a train job.
    InferSyncResources:
      properties:
        type:
          type: string
          const: infer_sync
          title: Type
          default: infer_sync
        model:
          $ref: '#/components/schemas/ModelVersionRef'
      type: object
      required:
        - model
      title: InferSyncResources
      description: Resources for a synchronous inference job.
    InferBatchResources:
      properties:
        type:
          type: string
          const: infer_batch
          title: Type
          default: infer_batch
        model:
          $ref: '#/components/schemas/ModelVersionRef'
        dataset:
          $ref: '#/components/schemas/DatasetVersionRef'
      type: object
      required:
        - model
        - dataset
      title: InferBatchResources
      description: Resources for a batch inference job.
    ValidationError:
      type: object
      required:
        - loc
        - msg
        - type
      properties:
        loc:
          type: array
          items:
            type: string
          title: Location
          description: Path to the field that caused the error.
        msg:
          type: string
          title: Message
          description: Human-readable error message.
        type:
          type: string
          title: Error Type
          description: Machine-readable error type identifier.
      title: ValidationError
    DatasetVersionRef:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        version_id:
          type: string
          format: uuid
          title: Version Id
        version_number:
          type: integer
          title: Version Number
      type: object
      required:
        - id
        - version_id
        - version_number
      title: DatasetVersionRef
      description: Dataset version reference.
    ModelVersionRef:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        version_id:
          type: string
          format: uuid
          title: Version Id
        version_number:
          type: integer
          title: Version Number
      type: object
      required:
        - id
        - version_id
        - version_number
      title: ModelVersionRef
      description: Model version reference.
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````