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

# Get generation status

> Retrieves metadata for a single queued generation.



## OpenAPI

````yaml https://dev.hub.oxen.ai/api/_spec/oxen_hub_api.json get /api/ai/queue/{generation_id}
openapi: 3.0.0
info:
  title: oxen
  version: 0.224.2
servers:
  - url: https://dev.hub.oxen.ai
    variables: {}
security: []
tags: []
paths:
  /api/ai/queue/{generation_id}:
    get:
      tags: []
      summary: Get generation status
      description: Retrieves metadata for a single queued generation.
      operationId: OxenApiWeb.Controllers.QueueController.show
      parameters:
        - description: ''
          in: path
          name: generation_id
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueueGenerationResponse'
          description: Generation details
        '404':
          content:
            application/json:
              schema:
                type: object
          description: Generation not found
      callbacks: {}
components:
  schemas:
    QueueGenerationResponse:
      description: >-
        Metadata for a single generation. Rows persist after terminal state
        transitions (succeeded, failed, cancelled), so this endpoint returns 200
        with the final status and `result_url` once the row is complete. The
        response also includes any additional parameters from the request that
        queued it.
      properties:
        completed_at:
          description: Unix timestamp
          nullable: true
          type: integer
        enqueued_at:
          description: Unix timestamp
          type: integer
        error_message:
          nullable: true
          type: string
        generation_id:
          format: uuid
          type: string
        media_type:
          enum:
            - image
            - video
          type: string
        model_name:
          type: string
        result_url:
          nullable: true
          type: string
        started_at:
          description: Unix timestamp
          nullable: true
          type: integer
        status:
          enum:
            - queued
            - processing
            - succeeded
            - failed
            - cancelled
          type: string
        target_directory:
          nullable: true
          type: string
        target_namespace:
          nullable: true
          type: string
        target_repo:
          nullable: true
          type: string
      required:
        - generation_id
        - model_name
        - media_type
        - status
        - enqueued_at
      title: QueueGenerationResponse
      type: object

````