PayerList Outages

The PayerList /outages endpoint enables providers comprehensive real-time visibility into payer product outages using the stand-inReason indicator as the primary identification mechanism. The API serves as a critical operational tool for monitoring and managing product availability across healthcare systems, enabling proactive outage management and system reliability.

The API enables operational teams to:

  • Providers can identify active product outages using the stand-inReason indicator flag
  • Providers can search for payer IDs for PayerId and AdditionalSupportedIDs
  • Monitor outage status across multiple healthcare systems (IMN, IEDI, EXCH, DENTAL, RPA), transaction type, and payer configuration
  • Provides providers can use multiple comma separated
    • Filter values function as an OR for: transactionType, system, imnPayerId, and standinReason
  • Support incident response with detailed outage information and affected product details
    • This service is essential for maintaining service reliability and ensuring transparent communication about product availability issues.
  • Filters outage fields
    • Payer Outage API by multiple values on certain fields, such as TransactionType, so that I can get a clear picture of outages with a single search
  • Response includes the issueStartDate
  • Exports outage data as CSV

Endpoints available

Outages

  • The /outages endpoint provides comprehensive real-time visibility into payer product outages.
https://sandbox-apigw.optum.com/medicalnetwork/payerlist/v1/outages

Request examples

GET /outages?system=IMN
GET /outages?system=IMN&payerProductStandinFlag=Yes&activeStatus=Active
GET /outages?system=IMN&startDateTimeAfter=2026-07-01&startDateTimeBefore=2026-07-31
GET /outages?system=IMN&issueStartDate=2026-07-15
GET /outages?system=IMN&payerName=Aetna&transactionType=Eligibility&wildcardSearch=Yes
GET /outages?system=IMN&transactionType=Eligibility&transactionType=Claim%20Status
GET /outages?system=IMN,EXCH
GET /outages?system=IMN&imnPayerId=3510,22222

Query parameters

ParameterAccepted ValuesRequiredDescription
systemIMN, IEDI, EXCH, RPA, DENTALYesFilters by network system. Supports
comma-separated values
payerProductStandinFlagYes/NoNoFilters by standin (outage) flag
activeStatusActive, Inactive, Standby,
Unknown
NoFilters by service availability status
startDateTimeAfterE.g., 2026-07-01NoReturns outages with a start date on or after this date
startDateTimeBeforeE.g., 2026-07-31NoReturn outages with a start date on or
before this date

Must be ≥ startDateTimeAfter
issueStartDateE.g. 2026-07-15NoReturn outages starting on exactly this
date
intermittentPayerOutageYes/NoNoFilter by intermittent vs full outage
transactionType
  • Eligibility,
  • Claims Institutional,
  • Claims Professional,
  • Claim Status,
  • ERA Institutional,
  • ERA Professional,
  • Auth Inquiry,
  • Auth Referral,
  • Claims Attachments,
  • Advanced Notification,
  • Dental
    Claims,
  • Dental Claim Attachments,
  • Dental ERA
NoFilter by transactionType. Repeat param or comma-separated
imnPayerIdE.g., 3510, 22222NoFilter by IMN Payer ID(s), supports comma-separated values
payerNameE.g, AetnaNoFilter by payerName, substring match
when wildcardSearch=Yes
standinReasonE.g., Optum outage, Payer
maintenance
NoFilter by standin reason(s), supports
comma-separated values
sortE.g., payerName, ascNoSort results; repeat for multi-sort

Format: field, asc|desc
wildcardSearchYes/NoNoEnable/disable substring matching for text filters
pageE.g, 1Page number for pagination
pageSizeE.g, 50NoNumber of results per page
exportFieldsE.g, imnPayerId, payerName, activeStatusNoComma-separated fields to include in export
Used with /outages/export endpoint

Response example

{
	"page": 1,
	"pageSize": 100,
	"total": 12,
	"outages": [
		{
			"system": "IMN",
			"imnPayerId": "71064",
			"payerName": "HEALTHCHOICE OKLAHOMA",
			"transactionType": "Claim Status",
			"payerProductStandinFlag": true,
			"standinReason": "",
			"intermittentPayerOutage": false,
			"additionalPayerIds": [],
			"issueStartDate": null
		},
		{
			"system": "IMN",
			"imnPayerId": "88058",
			"payerName": "MED-PAY",
			"transactionType": "Claim Status",
			"payerProductStandinFlag": true,
			"standinReason": "Payer Maintenance",
			"intermittentPayerOutage": false,
			"additionalPayerIds": [
				"88058",
				"MEDPY"
			],
			"issueStartDate": null
		},
		{
			"system": "IMN",
			"imnPayerId": "14165",
			"payerName": "MVP HEALTH CARE",
			"transactionType": "Eligibility",
			"payerProductStandinFlag": true,
			"standinReason": "Payer Outage",
			"intermittentPayerOutage": false,
			"additionalPayerIds": [],
			"issueStartDate": "2026-07-27"
		},
		{
			"system": "IMN",
			"imnPayerId": "38308",
			"payerName": "Christian Brothers Services",
			"transactionType": "Eligibility",
			"payerProductStandinFlag": true,
			"standinReason": "Payer Outage",
			"intermittentPayerOutage": false,
			"additionalPayerIds": [],
			"issueStartDate": null
		},
		{
			"system": "IMN",
			"imnPayerId": "52189",
			"payerName": "JOHNS HOPKINS HEALTHCARE / PRIORITY PARTNERS",
			"transactionType": "Eligibility",
			"payerProductStandinFlag": true,
			"standinReason": "Intermittent Payer Outage",
			"intermittentPayerOutage": true,
			"additionalPayerIds": [
				"11132"
			],
			"issueStartDate": "2026-07-27"
		},
		{
			"system": "IMN",
			"imnPayerId": "ALPBS",
			"payerName": "ALBUQUERQUE PUBLIC SCHOOLS",
			"transactionType": "Eligibility",
			"payerProductStandinFlag": true,
			"standinReason": "Payer Outage",
			"intermittentPayerOutage": false,
			"additionalPayerIds": [
				"ALPBS"
			],
			"issueStartDate": "2026-07-29"
		},
		{
			"system": "IMN",
			"imnPayerId": "DEMO2",
			"payerName": "DEMO HPS Payer",
			"transactionType": "Eligibility",
			"payerProductStandinFlag": true,
			"standinReason": "",
			"intermittentPayerOutage": false,
			"additionalPayerIds": [],
			"issueStartDate": null
		},
		{
			"system": "IMN",
			"imnPayerId": "LCNHG",
			"payerName": "LINCOLN HERITAGE LIFE INSURANCE COMPANY",
			"transactionType": "Eligibility",
			"payerProductStandinFlag": true,
			"standinReason": "Third Party Outage",
			"intermittentPayerOutage": false,
			"additionalPayerIds": [],
			"issueStartDate": null
		},
		{
			"system": "IMN",
			"imnPayerId": "SHMS1",
			"payerName": "SHARED HEALTH MISSISSIPPI",
			"transactionType": "Eligibility",
			"payerProductStandinFlag": true,
			"standinReason": "Payer Outage",
			"intermittentPayerOutage": false,
			"additionalPayerIds": [],
			"issueStartDate": "2026-07-27"
		},
		{
			"system": "IMN",
			"imnPayerId": "SKID0",
			"payerName": "IDAHO MEDICAID",
			"transactionType": "Eligibility",
			"payerProductStandinFlag": true,
			"standinReason": "Optum Maintenance",
			"intermittentPayerOutage": false,
			"additionalPayerIds": [],
			"issueStartDate": "2026-07-27"
		},
		{
			"system": "IMN",
			"imnPayerId": "TEST1",
			"payerName": "Testing",
			"transactionType": "Eligibility",
			"payerProductStandinFlag": true,
			"standinReason": "",
			"intermittentPayerOutage": false,
			"additionalPayerIds": [],
			"issueStartDate": null
		},
		{
			"system": "DENTAL",
			"imnPayerId": "65978",
			"payerName": "METLIFE",
			"transactionType": "Dental Claims",
			"payerProductStandinFlag": true,
			"standinReason": "",
			"intermittentPayerOutage": false,
			"additionalPayerIds": [],
			"issueStartDate": null
		}
	],
	"meta": {
		"applicationMode": "cert",
		"responseTime": 0.013005
	}
}

Export Outages

  • The /outages/export endpoint returns paginated results similar to the GET payers endpoint, which can be exported into a CSV format.
https://apigw.optum.com/medicalnetwork/payerlist/v1/outages/export
Outages/Export Example

Outages/Export Example

Outage Identification Fields

Primary Outage Indicators (Essential for Outage Detection)

FieldJSON TagValueOutage Purpose
payerProductStandinFlagpayer_product_standin_flagY/N (Yes/No)PRIMARY: Indicates product outage status
systemsystemIMN, IEDI, EXCH, DENTAL, RPACRITICAL: Outage scope identification
activeactiveY/N (Yes/No)ESSENTIAL: Service availability
payerNamepayer_nameStringIMPORTANT: Human-readable outage identification
transactionTypetransaction_type837P, 837I, ELIGIBILITYIMPORTANT: Affected service type

Notes and validation rules

  1. system is REQUIRED — every request must include it.
  2. Date fields strictly require YYYY-MM-DD format; datetime strings are rejected.
  3. startDateTimeBefore must be equal to or after startDateTimeAfter.
  4. transactionType and sort support both repeated params (&transactionType;=A&transactionType;=B) and comma-separated strings (&transactionType;=A,B).
  5. The same multi-value behavior applies to imnPayerId and standinReason.
  6. wildcardSearch defaults to Yes — substring matching is active unless explicitly set to No.
  7. The /outages/export endpoint accepts the same parameters and returns a CSV file.

Did this page help you?