| Parameter | Type | Default |
| limit | integer | 100 |
| offset | integer | 0 |
| search | string | (none) |
Response (200 OK)
{
"data": [
{
"id": "payer-uuid-1",
"name": "Cigna",
"state": "National",
"type": "Commercial",
"contact_email": "appeals@cigna.com"
},
{
"id": "payer-uuid-2",
"name": "Aetna",
"state": "National",
"type": "Commercial",
"contact_email": "appeals@aetna.com"
}
],
"total": 156,
"limit": 100,
"offset": 0
}
GET /api/registries/payers/:payerId
Get details for a specific payer.
Authentication: Not required
Authorization: Public
Credit Cost: None
Response (200 OK)
{
"id": "payer-uuid",
"name": "Cigna",
"state": "National",
"type": "Commercial",
"contact_email": "appeals@cigna.com",
"headquarters": "Hartford, CT",
"appeal_process": {
"initial_appeal_days": 30,
"standard_review_days": 30,
"expedited_review_days": 72,
"appeal_address": "...",
"appeal_phone": "..."
}
}
GET /api/registries/denial-reasons
List all denial reason codes and categories.
Authentication: Not required
Authorization: Public
Credit Cost: None
Query Parameters
| Parameter | Type | Default |
| category | string | (none) |
Response (200 OK)
{
"data": [
{
"code": "FREQ_LIMIT",
"description": "Frequency limit exceeded",
"category": "Benefit Limit",
"appeal_overturn_rate": 0.42
},
{
"code": "MED_NECESSITY",
"description": "Not medically necessary",
"category": "Clinical Justification",
"appeal_overturn_rate": 0.58
},
{
"code": "AUTH_REQUIRED",
"description": "Prior authorization required",
"category": "Administrative",
"appeal_overturn_rate": 0.73
}
],
"total": 47
}
GET /api/registries/states
List US states and territories.
Authentication: Not required
Authorization: Public
Credit Cost: None
Response (200 OK)
{
"data": [
{ "code": "AL", "name": "Alabama" },
{ "code": "AK", "name": "Alaska" },
{ "code": "AZ", "name": "Arizona" },
...
],
"total": 51
}
GET /api/registries/behavioral-health-services
List behavioral health service types.
Authentication: Not required
Authorization: Public
Credit Cost: None
Response (200 OK)
{
"data": [
{ "code": "IOP", "name": "Intensive Outpatient Program", "level_of_care": 2 },
{ "code": "PHP", "name": "Partial Hospitalization Program", "level_of_care": 3 },
{ "code": "RESID", "name": "Residential Treatment", "level_of_care": 4 },
{ "code": "INPATIENT", "name": "Inpatient Psychiatric", "level_of_care": 5 },
{ "code": "THERAPY", "name": "Individual Therapy", "level_of_care": 1 }
],
"total": 12
}
GET /api/registries/insurance-plans
List insurance plans (union contracts, employer plans, etc.) with coverage data.
Authentication: Not required
Authorization: Public
Credit Cost: None
Query Parameters
| Parameter | Type | Default | Example |
| payer | string | (none) | Cigna |
| state | string | (none) | CA |
| plan_year | integer | (none) | 2024 |
| service | string | (none) | IOP |
| limit | integer | 50 | 100 |
Response (200 OK)
{
"data": [
{
"id": "plan-uuid-1",
"payer": "Cigna",
"plan_name": "Cigna Open Access 2000",
"state": "CA",
"plan_year": 2024,
"plan_type": "PPO",
"coverage_data": {
"behavioral_health": {
"iop": {
"frequency_limit": "60 days per benefit year",
"requires_prior_auth": true,
"copay": "$30",
"deductible": "$1000"
}
},
"medical_necessity_criteria": {
"description": "Review based on functional status, not service duration"
}
}
}
],
"total": 234,
"limit": 50,
"offset": 0
}
GET /api/registries/academic-research
List peer-reviewed studies and research relevant to denial appeals.
Authentication: Not required
Authorization: Public
Credit Cost: None
Query Parameters
| Parameter | Type | Default |
| topic | string | (none) |
| limit | integer | 50 |