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

# Retrieve a prior authorization request

> Poll this resource for processing status. Failed operations return 200 with a structured error; successful operations include prior_authorization_id.



## OpenAPI

````yaml https://api.getsolum.com/openapi.json get /v1/prior-authorization-requests/{request_id}
openapi: 3.1.0
info:
  title: Solum Health API
  description: '## Solum Health Backend API '
  version: 1.0.0
servers: []
security: []
paths:
  /v1/prior-authorization-requests/{request_id}:
    get:
      tags:
        - Prior Authorization Requests
      summary: Retrieve a prior authorization request
      description: >-
        Poll this resource for processing status. Failed operations return 200
        with a structured error; successful operations include
        prior_authorization_id.
      operationId: retrieve_request_v1_prior_authorization_requests__request_id__get
      parameters:
        - name: request_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Request Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestView'
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Not Found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                    example: validation_error
                  code:
                    type: string
                    example: invalid_parameter
                  message:
                    type: string
                    example: Field validation failed
                  param:
                    type: string
                    example: phone_number
                required:
                  - type
                  - code
                  - message
      security:
        - APIKeyHeader: []
        - HTTPBearer: []
components:
  schemas:
    RequestView:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        status:
          $ref: '#/components/schemas/AsyncOperationStatus'
        prior_authorization_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Prior Authorization Id
        error:
          anyOf:
            - $ref: '#/components/schemas/RequestError'
            - type: 'null'
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
        completed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Completed At
      additionalProperties: false
      type: object
      required:
        - id
        - status
        - prior_authorization_id
        - error
        - created_at
        - updated_at
        - completed_at
      title: RequestView
    ErrorResponse:
      properties:
        type:
          type: string
          title: Type
        code:
          type: string
          title: Code
        message:
          type: string
          title: Message
        param:
          anyOf:
            - type: string
            - type: 'null'
          title: Param
        meta:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Meta
      additionalProperties: false
      type: object
      required:
        - type
        - code
        - message
      title: ErrorResponse
      description: >-
        Clean error response schema following RFC 7807 inspired format.


        Error is returned directly without wrapper, with all fields in
        snake_case.


        Fields:

        - type: Error category (e.g., "validation_error", "resource_error")

        - code: Specific error code (e.g., "resource_missing", "invalid_field")

        - message: Human-readable error message

        - param: The parameter that caused the error (optional)

        - meta: Generic free-form bag for resource-specific context (optional).
          For 409 resource_conflict responses the conflicting resource is nested
          here under the resource-specific key, e.g. ``meta.existing_patient``.
    AsyncOperationStatus:
      type: string
      enum:
        - queued
        - processing
        - completed
        - failed
      title: AsyncOperationStatus
    RequestError:
      properties:
        code:
          type: string
          title: Code
        message:
          type: string
          title: Message
        retryable:
          type: boolean
          title: Retryable
        fields:
          items:
            $ref: '#/components/schemas/FieldError'
          type: array
          title: Fields
      additionalProperties: false
      type: object
      required:
        - code
        - message
        - retryable
      title: RequestError
    FieldError:
      properties:
        path:
          type: string
          title: Path
        code:
          type: string
          title: Code
        message:
          type: string
          title: Message
      additionalProperties: false
      type: object
      required:
        - path
        - code
        - message
      title: FieldError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
    HTTPBearer:
      type: http
      scheme: bearer

````