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

# Read a platform build request

> Read one queued build request. Queueing a build answers with a request id before there is a build to read - the build row is created when the scheduler claims the request - so this is how a caller follows that gap: status is pending until the claim, and build_id names the build from then on. Answers 404 for every organisation without the platform_builds flag. Bearer PAT authentication (Authorization: Bearer <token>), with the organisation selected by the token or the X-Ankra-Organisation-Id override.



## OpenAPI

````yaml https://platform.ankra.app/openapi.json get /api/v1/org/applications/{application_id}/builds/requests/{request_id}
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers:
  - url: https://platform.ankra.app
security: []
paths:
  /api/v1/org/applications/{application_id}/builds/requests/{request_id}:
    get:
      tags:
        - applications
      summary: Read a platform build request
      description: >-
        Read one queued build request. Queueing a build answers with a request
        id before there is a build to read - the build row is created when the
        scheduler claims the request - so this is how a caller follows that gap:
        status is pending until the claim, and build_id names the build from
        then on. Answers 404 for every organisation without the platform_builds
        flag. Bearer PAT authentication (Authorization: Bearer <token>), with
        the organisation selected by the token or the X-Ankra-Organisation-Id
        override.
      operationId: get_application_platform_build_request_api_v1
      parameters:
        - in: path
          name: application_id
          required: true
          schema:
            title: Application Id
            type: string
        - in: path
          name: request_id
          required: true
          schema:
            title: Request Id
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlatformBuildRequestResponse'
          description: Successful Response
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DemoDetailError'
          description: >-
            Not found ("Platform build request not found", "Application not
            found", or the organisation lacks the platform_builds flag)
components:
  schemas:
    PlatformBuildRequestResponse:
      properties:
        request_id:
          title: Request Id
          type: string
        component:
          title: Component
          type: string
        head_sha:
          title: Head Sha
          type: string
        ref:
          title: Ref
          type: string
        reason:
          title: Reason
          type: string
          description: 'Why the build was asked for: first_onboard, push, retry or demo.'
        status:
          title: Status
          type: string
          description: >-
            pending until the scheduler claims the request, then claimed, then
            done; cancelled if it was withdrawn before a builder took it.
        build_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Build Id
          description: >-
            The build this request was claimed into; null while the request is
            still pending. Read it at
            /org/applications/{application_id}/builds/{build_id}.
        claimed_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Claimed At
          description: When a builder claimed the request; null while it is still pending.
        created_at:
          title: Created At
          type: string
      required:
        - request_id
        - component
        - head_sha
        - ref
        - reason
        - status
        - build_id
        - claimed_at
        - created_at
      title: PlatformBuildRequestResponse
      type: object
    DemoDetailError:
      description: >-
        The FastAPI-style detail envelope the demo routes use for
        400/403/404/409/502 responses.
      properties:
        detail:
          type: string
      required:
        - detail
      type: object

````