> ## Documentation Index
> Fetch the complete documentation index at: https://docs.medera.info/llms.txt
> Use this file to discover all available pages before exploring further.
# Quickstart — Prior Authorization
> Drive the 17-state PA workflow end-to-end.
The PA workflow runs through 17 documented states with payer-specific rules and 5-channel submission. Voice agent The PA Specialist handles outbound peer-to-peer calls.
## State machine
```text theme={"system"}
bash cURL curl -X POST https://api.medera.info/api/prior-auth/evaluate \ -H "X-API-Key: $MEDERA_API_KEY" \ -d '{ "patient_data": { "diagnosis_codes": ["F32.1"], "phq9_score": 14 }, "procedure_codes": ["90834"], "payer_id": "AETNA" }'
```
```typescript JavaScript const result = await client.pa.evaluate({ patient_data: { diagnosis_codes: ['F32.1'], phq9_score: 14 }, procedure_codes: ['90834'], payer_id: 'AETNA', }); // result.recommendation: AUTO_APPROVE theme={"system"}
| LIKELY_APPROVE | NEEDS_REVIEW | LIKELY_DENY
```
|
```text theme={"system"}
python Python result = client.pa.evaluate(patient_data={"diagnosis_codes": ["F32.1"], "phq9_score": 14}, procedure_codes=["90834"], payer_id="AETNA",)
```
```text theme={"system"}
bash cURL curl -X POST https://api.medera.info/api/prior-auth/requests \ -H "X-API-Key: $MEDERA_API_KEY" \ -d '{ "patient_id": "pat_abc", "diagnosis_codes": ["F32.1"], "procedure_codes": ["90834"], "clinical_justification": "...", "payer_id": "AETNA" }'
```
```text theme={"system"}
typescript JavaScript const req = await client.pa.createRequest({ patient_id: 'pat_abc', diagnosis_codes: ['F32.1'], procedure_codes: ['90834'], clinical_justification: '...', payer_id: 'AETNA', });
```
```text theme={"system"}
python Python req = client.pa.create_request(patient_id="pat_abc", diagnosis_codes=["F32.1"], procedure_codes=["90834"], clinical_justification="...", payer_id="AETNA",)
```
Initial state: `PA_INITIATED`.
```text theme={"system"}
bash cURL curl -X POST https://api.medera.info/api/prior-auth/documents/generate \ -H "X-API-Key: $MEDERA_API_KEY" \ -d '{ "request_id": "pa_abc", "document_types": ["MEDICAL_NECESSITY", "CLINICAL_SUMMARY"] }'
```
```text theme={"system"}
typescript JavaScript await client.pa.generateDocuments({ request_id: req.pa_id, document_types: ['MEDICAL_NECESSITY', 'CLINICAL_SUMMARY'], });
```
Submission selects the highest-priority available channel:
```text theme={"system"}
EPA_API → CLEARINGHOUSE → PORTAL → FAX → MANUAL
```
```text theme={"system"}
bash curl -X POST https://api.medera.info/api/prior-auth/requests/{id}/submit \ -H "X-API-Key: $MEDERA_API_KEY"
```
Poll status; if denied, generate the appeal with new evidence.
```text theme={"system"}
bash curl https://api.medera.info/api/prior-auth/requests/{id} \ -H "X-API-Key: $MEDERA_API_KEY" # If denied: curl -X POST https://api.medera.info/api/prior-auth/requests/{id}/appeal \ -H "X-API-Key: $MEDERA_API_KEY"
```
## Supported payers
`CARELON_ANTHEM`, `OPTUM_BH`, `MAGELLAN`, `EVERNORTH`, `UNITED_HEALTHCARE`, `AETNA`, `CIGNA`, `BLUE_CROSS`, `MEDICAID`, `MEDICARE`.
## Document types
`MEDICAL_NECESSITY`, `CLINICAL_SUMMARY`, `TREATMENT_PLAN`, `ASSESSMENT`, `PROGRESS_NOTE`, `DISCHARGE_SUMMARY` — plus X-12 EDI 278 for clearinghouse submission.
***
## What's next
Agent-level documentation.
Full REST surface.
Appeal lifecycle.
Pre-visit benefits.