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

# List Prior Authorizations

> Search submitted prior authorizations by any combination of plan identifiers (bin, pcn, group, state), diagnosis (icd_code), or patient name. All filters are optional; omit every filter to list all PAs. Filters combine with AND semantics.

<Tip>
  Search submitted prior authorizations by any combination of `bin`, `pcn`, `group`, `icd_code`, `state`, or patient `name`. All filters are optional — omit to list every PA. Filters combine with AND semantics.
</Tip>


## OpenAPI

````yaml GET /pa_list_prior_authorizations
openapi: 3.0.1
info:
  title: Simplex API
  description: API for browser automation, web scraping, and workflow automation
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.simplex.sh
security:
  - bearerAuth: []
paths:
  /pa_list_prior_authorizations:
    get:
      description: >-
        Search submitted prior authorizations by any combination of plan
        identifiers (bin, pcn, group, state), diagnosis (icd_code), or patient
        name. All filters are optional; omit every filter to list all PAs.
        Filters combine with AND semantics.
      parameters:
        - name: bin
          in: query
          required: false
          description: Filter by pharmacy BIN (e.g. "003858").
          schema:
            type: string
        - name: pcn
          in: query
          required: false
          description: Filter by Processor Control Number (e.g. "A4").
          schema:
            type: string
        - name: group
          in: query
          required: false
          description: Filter by insurance group number (e.g. "RXINN01").
          schema:
            type: string
        - name: icd_code
          in: query
          required: false
          description: Filter by exact ICD-10 diagnosis code (e.g. "E11.9").
          schema:
            type: string
        - name: state
          in: query
          required: false
          description: Filter by two-letter state code (e.g. "CA").
          schema:
            type: string
        - name: name
          in: query
          required: false
          description: Filter by patient name (partial match, case-insensitive).
          schema:
            type: string
      responses:
        '200':
          description: List prior authorizations response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaListPriorAuthorizationsResponse'
      x-codeSamples:
        - lang: python
          label: List prior authorizations
          source: |-
            import requests

            url = 'https://api.simplex.sh/pa_list_prior_authorizations'
            headers = {
                'X-API-Key': 'your_api_key_here'
            }
            params = {
                'bin': '003858',
                'state': 'CA',
                'icd_code': 'E11.9'
            }

            response = requests.get(url, headers=headers, params=params)
            result = response.json()
            for pa in result['prior_authorizations']:
                print(f"{pa['form_id']} — {pa['patient_name']} — {pa['status']}")
        - lang: curl
          label: List prior authorizations
          source: >-
            curl -X GET
            "https://api.simplex.sh/pa_list_prior_authorizations?bin=003858&state=CA&icd_code=E11.9"
            \
              -H "X-API-Key: your_api_key_here"
components:
  schemas:
    PaListPriorAuthorizationsResponse:
      type: object
      properties:
        succeeded:
          type: boolean
          description: Whether the search was successful.
        prior_authorizations:
          type: array
          description: Matching prior authorizations.
          items:
            type: object
            properties:
              form_id:
                type: string
                format: uuid
                description: UUID of the PA fax form.
              patient_name:
                type: string
                description: Patient full name.
              icd_code:
                type: string
                description: ICD-10 diagnosis code.
              medication:
                type: string
                description: Medication name and strength.
              payer_name:
                type: string
                description: Payer the PA was submitted to.
              bin:
                type: string
                description: Pharmacy BIN.
              pcn:
                type: string
                description: Processor Control Number.
              group:
                type: string
                description: Insurance group number.
              state:
                type: string
                description: Two-letter state code.
              status:
                type: string
                enum:
                  - SENT_TO_PLAN
                  - APPROVED
                  - DENIED
                  - ADDITIONAL_QUESTIONS
                  - APPEAL
                description: Current PA status.
              submitted_at:
                type: string
                format: date-time
                description: When the PA was transmitted.
              updated_at:
                type: string
                format: date-time
                description: When the status was last updated.
            required:
              - form_id
              - patient_name
              - status
              - submitted_at
      required:
        - succeeded
        - prior_authorizations
  securitySchemes:
    bearerAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Simplex API Key

````