---
title: "Create a PA status check"
method: POST
path: "/pa-status"
tags: ["public-api"]
---

# Create a PA status check

`POST /pa-status`

Create an asynchronous PA status check.

`instant_only` never falls back to standard processing. An ineligible or
failed instant check becomes a failed operation. `instant_preferred`
attempts instant processing first and permits standard fallback.

This contract-only stub currently returns 501 without creating a record.

## Request body

- CreatePaStatusRequest
  - `processing_method` 'instant_only' | 'instant_preferred', required — Requested processing policy. instant_only fails if instant processing cannot produce a result; instant_preferred permits standard fallback.
  - `priority` integer — Lower values indicate higher processing priority.
  - `patient` PaStatusPatient, required
    - `internal_id` string, required
    - `first_name` string, required
    - `last_name` string, required
    - `date_of_birth` string, date, required
    - `gender` 'male' | 'female' | 'other', required — Unspecified gender is not accepted for PA status checks.
    - `phone` string, nullable
    - `email` string, email, nullable
    - `mrn` string, nullable
    - `address` PaStatusAddress, required
      - `street` string, required
      - `street_line_2` string, nullable
      - `city` string, required
      - `state_province` string, required
      - `zip_postal_code` string, required
      - `country` string
  - `provider` PaStatusProvider, required
    - `internal_id` string, nullable
    - `first_name` string, required
    - `last_name` string, required
    - `npi` string, required
    - `phone` string, nullable
    - `fax` string, nullable
    - `address` PaStatusOptionalAddress, required
      - `street` string, nullable
      - `street_line_2` string, nullable
      - `city` string, nullable
      - `state_province` string, nullable
      - `zip_postal_code` string, nullable
      - `country` string, nullable
  - `prescription` PaStatusPrescription, required
    - `ndc` string, required — Medication National Drug Code. Segmented package NDCs and unsegmented 11-digit package NDCs are supported.
  - `insurances` PaStatusInsurance[], required — Insurance plans to check for the requested NDC.
    - union — Discrete insurance data and images for one plan.
      - object
        - `member_id` string, required
        - `member_name` string, nullable
        - `payer_name` string, nullable
        - `plan_name` string, nullable
        - `client_name` string, nullable
        - `group_number` string, nullable
        - `rx_bin` string, nullable
        - `rx_pcn` string, nullable
        - `rx_group` string, nullable
        - `images` PaStatusAsset[], nullable
          - union — Insurance image supplied by content or URL, but not both.
            - object
              - …
            - object
              - …
      - object
        - `member_name` string, required
        - `member_id` string, nullable
        - `payer_name` string, nullable
        - `plan_name` string, nullable
        - `client_name` string, nullable
        - `group_number` string, nullable
        - `rx_bin` string, nullable
        - `rx_pcn` string, nullable
        - `rx_group` string, nullable
        - `images` PaStatusAsset[], nullable
          - union — Insurance image supplied by content or URL, but not both.
            - object
              - …
            - object
              - …
      - object
        - `payer_name` string, required
        - `member_id` string, nullable
        - `member_name` string, nullable
        - `plan_name` string, nullable
        - `client_name` string, nullable
        - `group_number` string, nullable
        - `rx_bin` string, nullable
        - `rx_pcn` string, nullable
        - `rx_group` string, nullable
        - `images` PaStatusAsset[], nullable
          - union — Insurance image supplied by content or URL, but not both.
            - object
              - …
            - object
              - …
      - object
        - `plan_name` string, required
        - `member_id` string, nullable
        - `member_name` string, nullable
        - `payer_name` string, nullable
        - `client_name` string, nullable
        - `group_number` string, nullable
        - `rx_bin` string, nullable
        - `rx_pcn` string, nullable
        - `rx_group` string, nullable
        - `images` PaStatusAsset[], nullable
          - union — Insurance image supplied by content or URL, but not both.
            - object
              - …
            - object
              - …
      - object
        - `client_name` string, required
        - `member_id` string, nullable
        - `member_name` string, nullable
        - `payer_name` string, nullable
        - `plan_name` string, nullable
        - `group_number` string, nullable
        - `rx_bin` string, nullable
        - `rx_pcn` string, nullable
        - `rx_group` string, nullable
        - `images` PaStatusAsset[], nullable
          - union — Insurance image supplied by content or URL, but not both.
            - object
              - …
            - object
              - …
      - object
        - `group_number` string, required
        - `member_id` string, nullable
        - `member_name` string, nullable
        - `payer_name` string, nullable
        - `plan_name` string, nullable
        - `client_name` string, nullable
        - `rx_bin` string, nullable
        - `rx_pcn` string, nullable
        - `rx_group` string, nullable
        - `images` PaStatusAsset[], nullable
          - union — Insurance image supplied by content or URL, but not both.
            - object
              - …
            - object
              - …
      - object
        - `rx_bin` string, required
        - `member_id` string, nullable
        - `member_name` string, nullable
        - `payer_name` string, nullable
        - `plan_name` string, nullable
        - `client_name` string, nullable
        - `group_number` string, nullable
        - `rx_pcn` string, nullable
        - `rx_group` string, nullable
        - `images` PaStatusAsset[], nullable
          - union — Insurance image supplied by content or URL, but not both.
            - object
              - …
            - object
              - …
      - object
        - `rx_pcn` string, required
        - `member_id` string, nullable
        - `member_name` string, nullable
        - `payer_name` string, nullable
        - `plan_name` string, nullable
        - `client_name` string, nullable
        - `group_number` string, nullable
        - `rx_bin` string, nullable
        - `rx_group` string, nullable
        - `images` PaStatusAsset[], nullable
          - union — Insurance image supplied by content or URL, but not both.
            - object
              - …
            - object
              - …
      - object
        - `rx_group` string, required
        - `member_id` string, nullable
        - `member_name` string, nullable
        - `payer_name` string, nullable
        - `plan_name` string, nullable
        - `client_name` string, nullable
        - `group_number` string, nullable
        - `rx_bin` string, nullable
        - `rx_pcn` string, nullable
        - `images` PaStatusAsset[], nullable
          - union — Insurance image supplied by content or URL, but not both.
            - object
              - …
            - object
              - …
      - object
        - `images` PaStatusAsset[], required
          - union — Insurance image supplied by content or URL, but not both.
            - object
              - …
            - object
              - …
        - `member_id` string, nullable
        - `member_name` string, nullable
        - `payer_name` string, nullable
        - `plan_name` string, nullable
        - `client_name` string, nullable
        - `group_number` string, nullable
        - `rx_bin` string, nullable
        - `rx_pcn` string, nullable
        - `rx_group` string, nullable

## Response `200`

PA status check created; returns its current processing state.

- CreatePaStatusSuccessResponse — Successful response to POST /pa-status.
  - `status` 'success'
  - `error` unknown
  - `data` CreatePaStatusResponseData, required — Response metadata returned after creating a PA status check.
    - `id` string, required — Identifier used to poll the PA status GET endpoint.
    - `object` 'pa_status', required
    - `effective_processing_method` 'instant' | 'standard', required — Method currently running, that completed the operation, or that was most recently attempted before failure.
    - `status` 'pending' | 'completed' | 'failed', required
    - `failure_reason` PaStatusFailureReason, required
      - `code` 'instant_pa_status_ineligible' | 'instant_pa_status_failed' | 'standard_pa_status_failed', required
      - `message` string, required

## Other responses

- `422` — Validation Error
- `501` — PA status checking is not yet implemented.

---

[API](https://skmtc.net/develophealth/apis/develop-health-public-api.md) · [All operations](https://skmtc.net/develophealth/apis/develop-health-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/develophealth/develop-health-public-api/revisions/1684e1dda9be/schema)