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

# Get Benchmark Readiness

> Return whether a benchmark is ready to launch. A benchmark is ready when it is fully ingested, all required organization secrets are available, and all task environments are built. When it is not ready, the response identifies the remaining blockers.



## OpenAPI

````yaml /openapi.json get /api/v1/benchmarks/{bench_id}/readiness
openapi: 3.1.0
info:
  title: Trajectory API
  version: 0.1.0
servers:
  - url: https://api.trajectory.ai
security: []
paths:
  /api/v1/benchmarks/{bench_id}/readiness:
    get:
      tags:
        - benchmarks
      summary: Get Benchmark Readiness
      description: >-
        Return whether a benchmark is ready to launch. A benchmark is ready when
        it is fully ingested, all required organization secrets are available,
        and all task environments are built. When it is not ready, the response
        identifies the remaining blockers.
      operationId: getBenchmarkReadiness
      parameters:
        - name: bench_id
          in: path
          required: true
          schema:
            type: string
            title: Bench Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BenchmarkReadiness'
        default:
          $ref: '#/components/responses/ApiErrorResponse'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    BenchmarkReadiness:
      properties:
        ready:
          type: boolean
          title: Ready
          description: Whether the benchmark is fully ingested and ready to launch.
        missing_secret_names:
          items:
            type: string
          type: array
          title: Missing Secret Names
          description: Required organization secrets that are not available.
        unready_task_image_counts:
          additionalProperties:
            type: integer
          type: object
          title: Unready Task Image Counts
          description: >-
            Task environments that are not ready, grouped by preparation status.
            Empty when all task environments are built.
      type: object
      required:
        - ready
        - missing_secret_names
        - unready_task_image_counts
      title: BenchmarkReadiness
    ApiErrorEnvelope:
      properties:
        error:
          $ref: '#/components/schemas/ApiErrorBody'
      required:
        - error
      title: ApiErrorEnvelope
      type: object
    ApiErrorBody:
      properties:
        type:
          $ref: '#/components/schemas/ErrorType'
        code:
          title: Code
          type: string
        message:
          type: string
          title: Message
        param:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Param
        doc_url:
          type: string
          title: Doc Url
        context:
          additionalProperties: true
          title: Context
          type: object
      required:
        - type
        - code
        - message
        - doc_url
        - context
      title: ApiErrorBody
      type: object
    ErrorType:
      enum:
        - invalid_request_error
        - authentication_error
        - permission_error
        - conflict_error
        - rate_limit_error
        - dependency_error
        - api_error
      title: ErrorType
      type: string
  responses:
    ApiErrorResponse:
      description: >-
        Common API error. Possible codes: `authentication_required`,
        `permission_denied`, `validation_error`, `rate_limited`,
        `internal_error`, `service_unavailable`.
      headers:
        X-Request-ID:
          $ref: '#/components/headers/RequestId'
        Trajectory-Should-Retry:
          $ref: '#/components/headers/TrajectoryShouldRetry'
        Retry-After:
          $ref: '#/components/headers/RetryAfter'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiErrorEnvelope'
  headers:
    RequestId:
      schema:
        type: string
    TrajectoryShouldRetry:
      schema:
        type: boolean
    RetryAfter:
      schema:
        type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Organization API key

````