Search Payers

Search for payers by name, ID, or alias.

GET /payers/search

This endpoint queries the Payer Network. It's especially useful when you want to embed dynamic payer search capabilities into your system or application.

1. Call this endpoint with your desired search criteria. You can search by the payer's name, payer ID, or payer ID aliases. You can also filter the results by supported transaction types.
2. The endpoint returns information about matching payers, including their possible names, their primary payer ID, payer ID aliases, and supported transaction types.

The search supports fuzzy matching, which means that the results contain an array of exact (if available) and close matches.

Results

When you specify multiple transaction filters, they are combined with AND logic, meaning payers must satisfy all specified transaction criteria to be included in results.

Stedi weights results based on text match relevance and additional factors, such as payer size, market share, and transaction volume in order to present the most likely matches first. Stedi also accounts for potential misspellings (a search for CEGNA still returns CIGNA) and transposed letters (a search for ICGNA still returns CIGNA) when searching the payer database.

Examples

This page contains two examples of search results:

• Basic Search: The SearchPayers_example1 response shows the results of a basic search for the query string "Blue Cross". The URL for this request is https://healthcare.us.stedi.com/2024-04-01/payers/search?query=Blue%20Cross.
• Complex Search: The SearchPayers_example2 response shows the results of a more advanced search that includes a query string for "Blue Cross", plus additional query parameters that filter for payers supporting eligibility checks and real-time claim status. The URL for this request is https://healthcare.us.stedi.com/2024-04-01/payers/search?query=Blue%20Cross&eligibilityCheck=SUPPORTED&claimStatus=SUPPORTED. This advanced search only returns payers that support both eligibility checks and claim status, while the basic search returns all payers, regardless of the transaction types they support.

Both examples are truncated for brevity to show only one payer matching the results.

Authorizations

Authorization · Required Header

A Stedi API Key for authentication.

Query Parameters

pageSize · Integer Range: ≥ 10 and ≤ 100

The maximum number of elements to return in a page. If not specified, the default is 20.

pageToken · String Length: 1 - 1024

An opaque token returned by a previous call to this endpoint in the nextPageToken property. You can use it to request the next page of results. If not specified, Stedi returns the first page of results.

query · String Max length: 200

The query Stedi will use to search the Payer Network database. You can supply a payer's name, ID, or alias. The query is case-insensitive, and fuzzy matching is supported. For example, cig, 62308, and SX071 all return Cigna in the results. If not provided, the other search options are used to conduct the search.

eligibilityCheck · String

Transaction support filter values. When multiple transaction filters are specified, they are combined with AND logic (payers must satisfy all criteria).

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

EITHER

claimStatus · String

Transaction support filter values. When multiple transaction filters are specified, they are combined with AND logic (payers must satisfy all criteria).

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

EITHER

professionalClaimSubmission · String

Transaction support filter values. When multiple transaction filters are specified, they are combined with AND logic (payers must satisfy all criteria).

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

EITHER

dentalClaimSubmission · String

Transaction support filter values. When multiple transaction filters are specified, they are combined with AND logic (payers must satisfy all criteria).

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

EITHER

institutionalClaimSubmission · String

Transaction support filter values. When multiple transaction filters are specified, they are combined with AND logic (payers must satisfy all criteria).

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

EITHER

claimPayment · String

Transaction support filter values. When multiple transaction filters are specified, they are combined with AND logic (payers must satisfy all criteria).

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

EITHER

coordinationOfBenefits · String

Transaction support filter values. When multiple transaction filters are specified, they are combined with AND logic (payers must satisfy all criteria).

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

EITHER

unsolicitedClaimAttachment · String

Transaction support filter values. When multiple transaction filters are specified, they are combined with AND logic (payers must satisfy all criteria).

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

EITHER

coverageTypes · Array of Strings

Filter for matching payers that support transactions for all of the specified coverage types. For example, setting this array to ["medical", "dental"] returns only payers who provide both medical and dental coverage.

The results also exclude payers without coverage type classifications in Stedi's database.

Possible values

medical

dental

vision

operatingStates · Array of Strings

Filter for matching payers that operate in all of the specified states. For example, setting this array to ["CA", "OR"] returns only payers that operate in both California and Oregon, and setting it to ["NATIONAL"] returns payers that operate throughout the entire United States.

The results also exclude payers without operating state classifications in Stedi's database.

Possible values

AL

AK

AZ

AR

CA

Response

application/json

SearchPayers 200 response

items · Array of Objects Required

Matching payers sorted by relevance, with the most relevant matches listed first.

matches · items[].matches · Object

Shows which properties in the payer record match the search query. This information helps you understand why Stedi returned this payer and which parts of the payer record matched the search terms. It's also especially useful for debugging search queries and building user interfaces that display matching text.

• Matching text is wrapped in <b> HTML tags for highlighting.
• This object only contains properties with matching text. For example, if none of the payer's aliases matched the search query, this object will not include the aliases property.

aliases · items[].matches.aliases · Array of Strings

The parts of the payer's aliases that match the search query. Each alias that contains matching text is included as a separate entry, with matching portions wrapped in <b> tags. For example, searching for XYZ might return: [<b>XYZ</b>123, ABC<b>XYZ</b>].

displayName · items[].matches.displayName · String

The part of the payer's display name that matched the search query. For example, searching for Blue might return: Blue Cross <b>Blue</b> Shield.

names · items[].matches.names · Array of Strings

The parts of the payer's other names that match the search query. Each name that contains matching text is included as a separate entry, with matching portions wrapped in <b> tags. For example, searching for Health might return: [Community <b>Health</b> Plan, <b>Health</b> Partners].

primaryPayerId · items[].matches.primaryPayerId · String

The part of the primary payer ID that matched the search query. For example, if you search for '12345', the results for a payer with primary payer ID 12345ABC would return: <b>12345</b>ABC.

stediId · items[].matches.stediId · String

The part of the payer's Stedi payer ID that matched the search query. Stedi payer IDs only support exact substring matching (no prefix or fuzzy matching). For example, if you search for KRP, the results for a payer with Stedi payer ID 'KRPCH' would be: <b>KRP</b>CH.

payer · items[].payer · Object Required

A payer record matching the search query.

aliases · items[].payer.aliases · Array of Strings Required

Alternative IDs associated with a payer. If a payer changes their primaryPayerId, aliases allow you to continue sending transactions to the payer using the old ID uninterrupted.

avatarUrl · items[].payer.avatarUrl · String

A URL pointing to an image file (.png, .jpeg, or .jpg) with the payer's logo. This is the same logo Stedi displays in the Payer Network. You can use this property to display payer logos in your system or application.

This property is only returned when a payer logo is available.

coverageTypes · items[].payer.coverageTypes · Array of Strings

A list of insurance coverage types that indicates whether this payer supports transactions for medical coverage, dental coverage, vision coverage, or a combination of these. For example: ["medical"] or ["medical", "dental", "vision"].

When this array isn't in the response, it means Stedi hasn't classified the payer's coverage types yet, not that the payer doesn't support any coverage types.

Possible values

medical

dental

vision

displayName · items[].payer.displayName · String Required

The payer's business name, such as Cigna or Aetna. This is the name most commonly used to identify the payer.

employerIdentificationNumbers · items[].payer.employerIdentificationNumbers · Array of Strings

Employer Identification Numbers (EINs) associated with this payer.

enrollment · items[].payer.enrollment · Object

Information about the transaction enrollment process for this payer.

ptanRequired · items[].payer.enrollment.ptanRequired · Boolean

Whether a PTAN (Provider Transaction Access Number) is required for transaction enrollment.

The Provider Transaction Access Number (PTAN) is a Medicare-issued number given to providers upon enrollment with Medicare. This number is usually six digits and is assigned based on the type of service and the location of the provider. Upon enrollment, Medicare Administrating Contracting (MAC) providers should receive their assigned PTAN number in their approval letter.

transactionEnrollmentProcesses · items[].payer.enrollment.transactionEnrollmentProcesses · Object

Enrollment details for specific transaction types.

Stedi only returns this object when information about the enrollment process is available for one or more transaction types. When this object isn't included in the response, it doesn't mean no transaction types require enrollment. Refer to the transactionSupport object for details about which transaction types require enrollment.

claimPayment · items[].payer.enrollment.transactionEnrollmentProcesses.claimPayment · Object

Details about the enrollment process for Electronic Remittance Advice (ERAs) with this payer.

timeframe · items[].payer.enrollment.transactionEnrollmentProcesses.claimPayment.timeframe · String

Stedi's expected timeframe for completing the transaction enrollment process. INSTANT indicates that the enrollment will be in LIVE status within minutes of submitting the request.

Possible values

INSTANT

HOURS

DAYS

WEEKS

type · items[].payer.enrollment.transactionEnrollmentProcesses.claimPayment.type · String

Whether transaction enrollment is single or multi-step.

• ONE_CLICK indicates that once you submit the transaction enrollment request, Stedi can complete the rest of the enrollment process without any further action from you.
• MULTI_STEP indicates that you must complete additional steps to finish the enrollment process. Customer support will reach out with clear instructions explaining how to complete any remaining steps.

Possible values

ONE_CLICK

MULTI_STEP

claimStatusInquiry · items[].payer.enrollment.transactionEnrollmentProcesses.claimStatusInquiry · Object

Details about the enrollment process for real-time claim status requests with this payer.

timeframe · items[].payer.enrollment.transactionEnrollmentProcesses.claimStatusInquiry.timeframe · String

Stedi's expected timeframe for completing the transaction enrollment process. INSTANT indicates that the enrollment will be in LIVE status within minutes of submitting the request.

Possible values

INSTANT

HOURS

DAYS

WEEKS

type · items[].payer.enrollment.transactionEnrollmentProcesses.claimStatusInquiry.type · String

Whether transaction enrollment is single or multi-step.

• ONE_CLICK indicates that once you submit the transaction enrollment request, Stedi can complete the rest of the enrollment process without any further action from you.
• MULTI_STEP indicates that you must complete additional steps to finish the enrollment process. Customer support will reach out with clear instructions explaining how to complete any remaining steps.

Possible values

ONE_CLICK

MULTI_STEP

coordinationOfBenefits · items[].payer.enrollment.transactionEnrollmentProcesses.coordinationOfBenefits · Object

Details about the enrollment process for coordination of benefits (COB) checks with this payer.

timeframe · items[].payer.enrollment.transactionEnrollmentProcesses.coordinationOfBenefits.timeframe · String

Stedi's expected timeframe for completing the transaction enrollment process. INSTANT indicates that the enrollment will be in LIVE status within minutes of submitting the request.

Possible values

INSTANT

HOURS

DAYS

WEEKS

type · items[].payer.enrollment.transactionEnrollmentProcesses.coordinationOfBenefits.type · String

Whether transaction enrollment is single or multi-step.

• ONE_CLICK indicates that once you submit the transaction enrollment request, Stedi can complete the rest of the enrollment process without any further action from you.
• MULTI_STEP indicates that you must complete additional steps to finish the enrollment process. Customer support will reach out with clear instructions explaining how to complete any remaining steps.

Possible values

ONE_CLICK

MULTI_STEP

dentalClaim · items[].payer.enrollment.transactionEnrollmentProcesses.dentalClaim · Object

Details about the enrollment process for dental claim submission with this payer.

timeframe · items[].payer.enrollment.transactionEnrollmentProcesses.dentalClaim.timeframe · String

Stedi's expected timeframe for completing the transaction enrollment process. INSTANT indicates that the enrollment will be in LIVE status within minutes of submitting the request.

Possible values

INSTANT

HOURS

DAYS

WEEKS

type · items[].payer.enrollment.transactionEnrollmentProcesses.dentalClaim.type · String

Whether transaction enrollment is single or multi-step.

• ONE_CLICK indicates that once you submit the transaction enrollment request, Stedi can complete the rest of the enrollment process without any further action from you.
• MULTI_STEP indicates that you must complete additional steps to finish the enrollment process. Customer support will reach out with clear instructions explaining how to complete any remaining steps.

Possible values

ONE_CLICK

MULTI_STEP

eligibilityInquiry · items[].payer.enrollment.transactionEnrollmentProcesses.eligibilityInquiry · Object

Details about the enrollment process for eligibility checks with this payer.

timeframe · items[].payer.enrollment.transactionEnrollmentProcesses.eligibilityInquiry.timeframe · String

Stedi's expected timeframe for completing the transaction enrollment process. INSTANT indicates that the enrollment will be in LIVE status within minutes of submitting the request.

Possible values

INSTANT

HOURS

DAYS

WEEKS

type · items[].payer.enrollment.transactionEnrollmentProcesses.eligibilityInquiry.type · String

Whether transaction enrollment is single or multi-step.

• ONE_CLICK indicates that once you submit the transaction enrollment request, Stedi can complete the rest of the enrollment process without any further action from you.
• MULTI_STEP indicates that you must complete additional steps to finish the enrollment process. Customer support will reach out with clear instructions explaining how to complete any remaining steps.

Possible values

ONE_CLICK

MULTI_STEP

institutionalClaim · items[].payer.enrollment.transactionEnrollmentProcesses.institutionalClaim · Object

Details about the enrollment process for institutional claim submission with this payer.

timeframe · items[].payer.enrollment.transactionEnrollmentProcesses.institutionalClaim.timeframe · String

Stedi's expected timeframe for completing the transaction enrollment process. INSTANT indicates that the enrollment will be in LIVE status within minutes of submitting the request.

Possible values

INSTANT

HOURS

DAYS

WEEKS

type · items[].payer.enrollment.transactionEnrollmentProcesses.institutionalClaim.type · String

Whether transaction enrollment is single or multi-step.

• ONE_CLICK indicates that once you submit the transaction enrollment request, Stedi can complete the rest of the enrollment process without any further action from you.
• MULTI_STEP indicates that you must complete additional steps to finish the enrollment process. Customer support will reach out with clear instructions explaining how to complete any remaining steps.

Possible values

ONE_CLICK

MULTI_STEP

professionalClaim · items[].payer.enrollment.transactionEnrollmentProcesses.professionalClaim · Object

Details about the enrollment process for professional claim submission with this payer.

timeframe · items[].payer.enrollment.transactionEnrollmentProcesses.professionalClaim.timeframe · String

Stedi's expected timeframe for completing the transaction enrollment process. INSTANT indicates that the enrollment will be in LIVE status within minutes of submitting the request.

Possible values

INSTANT

HOURS

DAYS

WEEKS

type · items[].payer.enrollment.transactionEnrollmentProcesses.professionalClaim.type · String

Whether transaction enrollment is single or multi-step.

• ONE_CLICK indicates that once you submit the transaction enrollment request, Stedi can complete the rest of the enrollment process without any further action from you.
• MULTI_STEP indicates that you must complete additional steps to finish the enrollment process. Customer support will reach out with clear instructions explaining how to complete any remaining steps.

Possible values

ONE_CLICK

MULTI_STEP

unsolicitedClaimAttachment · items[].payer.enrollment.transactionEnrollmentProcesses.unsolicitedClaimAttachment · Object

Details about the enrollment process for unsolicited claim attachments with this payer.

timeframe · items[].payer.enrollment.transactionEnrollmentProcesses.unsolicitedClaimAttachment.timeframe · String

Stedi's expected timeframe for completing the transaction enrollment process. INSTANT indicates that the enrollment will be in LIVE status within minutes of submitting the request.

Possible values

INSTANT

HOURS

DAYS

WEEKS

type · items[].payer.enrollment.transactionEnrollmentProcesses.unsolicitedClaimAttachment.type · String

Whether transaction enrollment is single or multi-step.

• ONE_CLICK indicates that once you submit the transaction enrollment request, Stedi can complete the rest of the enrollment process without any further action from you.
• MULTI_STEP indicates that you must complete additional steps to finish the enrollment process. Customer support will reach out with clear instructions explaining how to complete any remaining steps.

Possible values

ONE_CLICK

MULTI_STEP

names · items[].payer.names · Array of Strings Required

Alternative names associated with a payer. These additional names help you search for and identify payers using the name most familiar to your organization.

operatingStates · items[].payer.operatingStates · Array of Strings

A list of US state codes, territories, or NATIONAL that indicates the geographic regions where this payer operates. For example: ["CA", "OR"] for a regional payer, or ["NATIONAL"] for a payer that operates throughout the entire United States.

When this array isn't in the response, it means Stedi hasn't classified the payer's operating states yet.

Possible values

AL

AK

AZ

AR

CA

parentPayerGroupId · items[].payer.parentPayerGroupId · String

The parent payer group entity this payer belongs to. This is for metadata purposes and doesn't necessarily relate to the payer's enrollment process or other capabilities.

primaryPayerId · items[].payer.primaryPayerId · String Required

The most commonly used ID for a payer. This value often corresponds to the name the payer uses internally and provides to patients on member ID cards.

stediId · items[].payer.stediId · String Required

A unique ID that Stedi assigned to this payer and uses internally for routing requests. This ID will not change even if the primaryPayerId is updated.

transactionSupport · items[].payer.transactionSupport · Object Required

Whether the following transaction types are supported: 270 eligibility checks, 276/277 claim status requests, 837 claims (professional, dental, institutional), 835 ERAs (claim payments), 275 unsolicited claim attachments, and coordination of benefits checks.

If the value is ENROLLMENT_REQUIRED, Stedi supports the transaction type, but you must enroll with the payer first.

claimPayment · items[].payer.transactionSupport.claimPayment · String Required

Whether you can receive 835 Electronic Remittance Advice (ERA) transactions from this payer.

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

claimStatus · items[].payer.transactionSupport.claimStatus · String Required

Whether you can send 276 claim status requests to this payer.

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

coordinationOfBenefits · items[].payer.transactionSupport.coordinationOfBenefits · String Required

Coordination of Benefits (COB) support.

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

dentalClaimSubmission · items[].payer.transactionSupport.dentalClaimSubmission · String Required

Whether you can send 837D dental claims to this payer.

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

eligibilityCheck · items[].payer.transactionSupport.eligibilityCheck · String Required

Whether you can send 270 eligibility checks to this payer.

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

institutionalClaimSubmission · items[].payer.transactionSupport.institutionalClaimSubmission · String Required

Whether you can send 837I institutional claims to this payer.

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

professionalClaimSubmission · items[].payer.transactionSupport.professionalClaimSubmission · String Required

Whether you can send 837P professional claims to this payer.

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

unsolicitedClaimAttachment · items[].payer.transactionSupport.unsolicitedClaimAttachment · String Required

Whether you can send unsolicited claim attachments to this payer.

Possible values

SUPPORTED

NOT_SUPPORTED

ENROLLMENT_REQUIRED

urls · items[].payer.urls · Object

URLs associated with this payer, such as their website. This object is only returned when URL information is available for the payer.

website · items[].payer.urls.website · String

The payer's website URL.

score · items[].score · Number Required Deprecated Format: double

A relevance score indicating how well this payer matched the search query. Higher scores are better matches. The minimum score is 0.

nextPageToken · String Length: 1 - 1024

Token for pagination to retrieve the next page of results; null if there are no more results

stats · Object Required

Statistics about the search results, including the total number of payers matching the search query and the number of payers supported per transaction type.

total · stats.total · Integer Required Range: ≥ 0

Total number of payers matching the search query.

transactionSupport · stats.transactionSupport · Object Required Deprecated

Number of matching payers supported per transaction type.

The categories for each transaction type are mutually exclusive. For example, to calculate the total number of payers that support eligibility checks, regardless of whether enrollment is required, you must add the supported and enrollmentRequired counts together.

DEPRECATED This shape is deprecated since 2025-06-24: Use the transactionSupportCounts property instead.

claimPayment · stats.transactionSupport.claimPayment · Object Required

Number of matching payers that support 835 Electronic Remittance Advices (ERAs).

enrollmentRequired · stats.transactionSupport.claimPayment.enrollmentRequired · Integer Required Range: ≥ 0

Number of matching payers that require transaction enrollment for this transaction type.

notSupported · stats.transactionSupport.claimPayment.notSupported · Integer Required Range: ≥ 0

Number of matching payers that don't support this transaction type.

supported · stats.transactionSupport.claimPayment.supported · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type.

claimStatus · stats.transactionSupport.claimStatus · Object Required

Number of matching payers that support 276/277 real-time claim status.

enrollmentRequired · stats.transactionSupport.claimStatus.enrollmentRequired · Integer Required Range: ≥ 0

Number of matching payers that require transaction enrollment for this transaction type.

notSupported · stats.transactionSupport.claimStatus.notSupported · Integer Required Range: ≥ 0

Number of matching payers that don't support this transaction type.

supported · stats.transactionSupport.claimStatus.supported · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type.

coordinationOfBenefits · stats.transactionSupport.coordinationOfBenefits · Object Required

Number of matching payers that support 270/271 coordination of benefits (COB) checks.

enrollmentRequired · stats.transactionSupport.coordinationOfBenefits.enrollmentRequired · Integer Required Range: ≥ 0

Number of matching payers that require transaction enrollment for this transaction type.

notSupported · stats.transactionSupport.coordinationOfBenefits.notSupported · Integer Required Range: ≥ 0

Number of matching payers that don't support this transaction type.

supported · stats.transactionSupport.coordinationOfBenefits.supported · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type.

dentalClaimSubmission · stats.transactionSupport.dentalClaimSubmission · Object Required

Number of matching payers that support 837D dental claims.

enrollmentRequired · stats.transactionSupport.dentalClaimSubmission.enrollmentRequired · Integer Required Range: ≥ 0

Number of matching payers that require transaction enrollment for this transaction type.

notSupported · stats.transactionSupport.dentalClaimSubmission.notSupported · Integer Required Range: ≥ 0

Number of matching payers that don't support this transaction type.

supported · stats.transactionSupport.dentalClaimSubmission.supported · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type.

eligibilityCheck · stats.transactionSupport.eligibilityCheck · Object Required

Number of matching payers that support 270/271 eligibility checks.

enrollmentRequired · stats.transactionSupport.eligibilityCheck.enrollmentRequired · Integer Required Range: ≥ 0

Number of matching payers that require transaction enrollment for this transaction type.

notSupported · stats.transactionSupport.eligibilityCheck.notSupported · Integer Required Range: ≥ 0

Number of matching payers that don't support this transaction type.

supported · stats.transactionSupport.eligibilityCheck.supported · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type.

institutionalClaimSubmission · stats.transactionSupport.institutionalClaimSubmission · Object Required

Number of matching payers that support 837I institutional claims.

enrollmentRequired · stats.transactionSupport.institutionalClaimSubmission.enrollmentRequired · Integer Required Range: ≥ 0

Number of matching payers that require transaction enrollment for this transaction type.

notSupported · stats.transactionSupport.institutionalClaimSubmission.notSupported · Integer Required Range: ≥ 0

Number of matching payers that don't support this transaction type.

supported · stats.transactionSupport.institutionalClaimSubmission.supported · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type.

professionalClaimSubmission · stats.transactionSupport.professionalClaimSubmission · Object Required

Number of matching payers that support 837P professional claims.

enrollmentRequired · stats.transactionSupport.professionalClaimSubmission.enrollmentRequired · Integer Required Range: ≥ 0

Number of matching payers that require transaction enrollment for this transaction type.

notSupported · stats.transactionSupport.professionalClaimSubmission.notSupported · Integer Required Range: ≥ 0

Number of matching payers that don't support this transaction type.

supported · stats.transactionSupport.professionalClaimSubmission.supported · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type.

unsolicitedClaimAttachment · stats.transactionSupport.unsolicitedClaimAttachment · Object Required

Number of matching payers that support 275 unsolicited claim attachments.

enrollmentRequired · stats.transactionSupport.unsolicitedClaimAttachment.enrollmentRequired · Integer Required Range: ≥ 0

Number of matching payers that require transaction enrollment for this transaction type.

notSupported · stats.transactionSupport.unsolicitedClaimAttachment.notSupported · Integer Required Range: ≥ 0

Number of matching payers that don't support this transaction type.

supported · stats.transactionSupport.unsolicitedClaimAttachment.supported · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type.

transactionSupportCounts · stats.transactionSupportCounts · Object Required

Number of matching payers for each supported transaction type.

To get the total number of payers that support each transaction type, with additional detail on whether enrollment is required, use supported.total instead.

claimPayment · stats.transactionSupportCounts.claimPayment · Object Required

Number of matching payers that support 835 Electronic Remittance Advices (ERAs).

notSupported · stats.transactionSupportCounts.claimPayment.notSupported · Object Required

Number of matching payers that don't support this transaction type.

total · stats.transactionSupportCounts.claimPayment.notSupported.total · Integer Required Range: ≥ 0

Total number of matching payers that don't support this transaction type.

supported · stats.transactionSupportCounts.claimPayment.supported · Object Required

Number of matching payers that support this transaction type, broken down by enrollment requirements.

enrollmentNotRequired · stats.transactionSupportCounts.claimPayment.supported.enrollmentNotRequired · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type and don't require transaction enrollment.

enrollmentRequired · stats.transactionSupportCounts.claimPayment.supported.enrollmentRequired · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type and require transaction enrollment.

total · stats.transactionSupportCounts.claimPayment.supported.total · Integer Required Range: ≥ 0

Total number of matching payers that support this transaction type (enrollmentRequired + enrollmentNotRequired).

claimStatus · stats.transactionSupportCounts.claimStatus · Object Required

Number of matching payers that support 276/277 real-time claim status.

notSupported · stats.transactionSupportCounts.claimStatus.notSupported · Object Required

Number of matching payers that don't support this transaction type.

total · stats.transactionSupportCounts.claimStatus.notSupported.total · Integer Required Range: ≥ 0

Total number of matching payers that don't support this transaction type.

supported · stats.transactionSupportCounts.claimStatus.supported · Object Required

Number of matching payers that support this transaction type, broken down by enrollment requirements.

enrollmentNotRequired · stats.transactionSupportCounts.claimStatus.supported.enrollmentNotRequired · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type and don't require transaction enrollment.

enrollmentRequired · stats.transactionSupportCounts.claimStatus.supported.enrollmentRequired · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type and require transaction enrollment.

total · stats.transactionSupportCounts.claimStatus.supported.total · Integer Required Range: ≥ 0

Total number of matching payers that support this transaction type (enrollmentRequired + enrollmentNotRequired).

coordinationOfBenefits · stats.transactionSupportCounts.coordinationOfBenefits · Object Required

Number of matching payers that support 270/271 coordination of benefits (COB) checks.

notSupported · stats.transactionSupportCounts.coordinationOfBenefits.notSupported · Object Required

Number of matching payers that don't support this transaction type.

total · stats.transactionSupportCounts.coordinationOfBenefits.notSupported.total · Integer Required Range: ≥ 0

Total number of matching payers that don't support this transaction type.

supported · stats.transactionSupportCounts.coordinationOfBenefits.supported · Object Required

Number of matching payers that support this transaction type, broken down by enrollment requirements.

enrollmentNotRequired · stats.transactionSupportCounts.coordinationOfBenefits.supported.enrollmentNotRequired · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type and don't require transaction enrollment.

enrollmentRequired · stats.transactionSupportCounts.coordinationOfBenefits.supported.enrollmentRequired · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type and require transaction enrollment.

total · stats.transactionSupportCounts.coordinationOfBenefits.supported.total · Integer Required Range: ≥ 0

Total number of matching payers that support this transaction type (enrollmentRequired + enrollmentNotRequired).

dentalClaimSubmission · stats.transactionSupportCounts.dentalClaimSubmission · Object Required

Number of matching payers that support 837D dental claims.

notSupported · stats.transactionSupportCounts.dentalClaimSubmission.notSupported · Object Required

Number of matching payers that don't support this transaction type.

total · stats.transactionSupportCounts.dentalClaimSubmission.notSupported.total · Integer Required Range: ≥ 0

Total number of matching payers that don't support this transaction type.

supported · stats.transactionSupportCounts.dentalClaimSubmission.supported · Object Required

Number of matching payers that support this transaction type, broken down by enrollment requirements.

enrollmentNotRequired · stats.transactionSupportCounts.dentalClaimSubmission.supported.enrollmentNotRequired · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type and don't require transaction enrollment.

enrollmentRequired · stats.transactionSupportCounts.dentalClaimSubmission.supported.enrollmentRequired · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type and require transaction enrollment.

total · stats.transactionSupportCounts.dentalClaimSubmission.supported.total · Integer Required Range: ≥ 0

Total number of matching payers that support this transaction type (enrollmentRequired + enrollmentNotRequired).

eligibilityCheck · stats.transactionSupportCounts.eligibilityCheck · Object Required

Number of matching payers that support 270/271 eligibility checks.

notSupported · stats.transactionSupportCounts.eligibilityCheck.notSupported · Object Required

Number of matching payers that don't support this transaction type.

total · stats.transactionSupportCounts.eligibilityCheck.notSupported.total · Integer Required Range: ≥ 0

Total number of matching payers that don't support this transaction type.

supported · stats.transactionSupportCounts.eligibilityCheck.supported · Object Required

Number of matching payers that support this transaction type, broken down by enrollment requirements.

enrollmentNotRequired · stats.transactionSupportCounts.eligibilityCheck.supported.enrollmentNotRequired · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type and don't require transaction enrollment.

enrollmentRequired · stats.transactionSupportCounts.eligibilityCheck.supported.enrollmentRequired · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type and require transaction enrollment.

total · stats.transactionSupportCounts.eligibilityCheck.supported.total · Integer Required Range: ≥ 0

Total number of matching payers that support this transaction type (enrollmentRequired + enrollmentNotRequired).

institutionalClaimSubmission · stats.transactionSupportCounts.institutionalClaimSubmission · Object Required

Number of matching payers that support 837I institutional claims.

notSupported · stats.transactionSupportCounts.institutionalClaimSubmission.notSupported · Object Required

Number of matching payers that don't support this transaction type.

total · stats.transactionSupportCounts.institutionalClaimSubmission.notSupported.total · Integer Required Range: ≥ 0

Total number of matching payers that don't support this transaction type.

supported · stats.transactionSupportCounts.institutionalClaimSubmission.supported · Object Required

Number of matching payers that support this transaction type, broken down by enrollment requirements.

enrollmentNotRequired · stats.transactionSupportCounts.institutionalClaimSubmission.supported.enrollmentNotRequired · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type and don't require transaction enrollment.

enrollmentRequired · stats.transactionSupportCounts.institutionalClaimSubmission.supported.enrollmentRequired · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type and require transaction enrollment.

total · stats.transactionSupportCounts.institutionalClaimSubmission.supported.total · Integer Required Range: ≥ 0

Total number of matching payers that support this transaction type (enrollmentRequired + enrollmentNotRequired).

professionalClaimSubmission · stats.transactionSupportCounts.professionalClaimSubmission · Object Required

Number of matching payers that support 837P professional claims.

notSupported · stats.transactionSupportCounts.professionalClaimSubmission.notSupported · Object Required

Number of matching payers that don't support this transaction type.

total · stats.transactionSupportCounts.professionalClaimSubmission.notSupported.total · Integer Required Range: ≥ 0

Total number of matching payers that don't support this transaction type.

supported · stats.transactionSupportCounts.professionalClaimSubmission.supported · Object Required

Number of matching payers that support this transaction type, broken down by enrollment requirements.

enrollmentNotRequired · stats.transactionSupportCounts.professionalClaimSubmission.supported.enrollmentNotRequired · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type and don't require transaction enrollment.

enrollmentRequired · stats.transactionSupportCounts.professionalClaimSubmission.supported.enrollmentRequired · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type and require transaction enrollment.

total · stats.transactionSupportCounts.professionalClaimSubmission.supported.total · Integer Required Range: ≥ 0

Total number of matching payers that support this transaction type (enrollmentRequired + enrollmentNotRequired).

unsolicitedClaimAttachment · stats.transactionSupportCounts.unsolicitedClaimAttachment · Object Required

Number of matching payers that support 275 unsolicited claim attachments.

notSupported · stats.transactionSupportCounts.unsolicitedClaimAttachment.notSupported · Object Required

Number of matching payers that don't support this transaction type.

total · stats.transactionSupportCounts.unsolicitedClaimAttachment.notSupported.total · Integer Required Range: ≥ 0

Total number of matching payers that don't support this transaction type.

supported · stats.transactionSupportCounts.unsolicitedClaimAttachment.supported · Object Required

Number of matching payers that support this transaction type, broken down by enrollment requirements.

enrollmentNotRequired · stats.transactionSupportCounts.unsolicitedClaimAttachment.supported.enrollmentNotRequired · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type and don't require transaction enrollment.

enrollmentRequired · stats.transactionSupportCounts.unsolicitedClaimAttachment.supported.enrollmentRequired · Integer Required Range: ≥ 0

Number of matching payers that support this transaction type and require transaction enrollment.

total · stats.transactionSupportCounts.unsolicitedClaimAttachment.supported.total · Integer Required Range: ≥ 0

Total number of matching payers that support this transaction type (enrollmentRequired + enrollmentNotRequired).

cURL

curl --request GET \
  --url "https://healthcare.us.stedi.com/2024-04-01/payers/search?query=Blue+Cross" \
  --header "Authorization: <api_key>"

JavaScript

fetch("https://healthcare.us.stedi.com/2024-04-01/payers/search?query=Blue+Cross", {
  headers: {
    "Authorization": "<api_key>"
  }
})

Go

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://healthcare.us.stedi.com/2024-04-01/payers/search?query=Blue+Cross"

  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "<api_key>")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}

Python

import requests

url = "https://healthcare.us.stedi.com/2024-04-01/payers/search?query=Blue+Cross"

response = requests.request("GET", url, headers = {
  "Authorization": "<api_key>"
})

print(response.text)

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.time.Duration;

HttpClient client = HttpClient.newBuilder()
  .connectTimeout(Duration.ofSeconds(10))
  .build();

HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
  .uri(URI.create("https://healthcare.us.stedi.com/2024-04-01/payers/search?query=Blue+Cross"))
  .header("Authorization", "<api_key>")
  .GET()
  .build();

try {
  HttpResponse<String> response = client.send(requestBuilder.build(), BodyHandlers.ofString());
  System.out.println("Status code: " + response.statusCode());
  System.out.println("Response body: " + response.body());
} catch (Exception e) {
  e.printStackTrace();
}

200

{
  "items": [
    {
      "matches": {
        "aliases": [
          "<b>BCBSM</b>",
          "<b>BCMIC</b>",
          "<b>BCMIH</b>",
          "<b>BCMIV</b>"
        ],
        "displayName": "<b>Blue</b> <b>Cross</b> <b>Blue</b> <b>Shield</b> of Michigan",
        "names": [
          "<b>BCBSM</b> Healthy Kids Dental (DentaQuest)",
          "<b>Blue</b> Care Network (<b>BCBSM</b> MA/BNCA - Medicare Advantage)",
          "<b>Blue</b> <b>Cross</b> <b>Blue</b> <b>Shield</b> Michigan Dental",
          "<b>Blue</b> <b>Cross</b> <b>Blue</b> <b>Shield</b> Michigan Institutional",
          "<b>Blue</b> <b>Cross</b> <b>Blue</b> <b>Shield</b> Michigan Professional",
          "<b>Blue</b> <b>Cross</b> <b>Blue</b> <b>Shield</b> of Michigan - Medicare Advantage",
          "<b>Blue</b> <b>Cross</b> <b>Blue</b> <b>Shield</b> of Michigan and <b>Blue</b> Care Network"
        ]
      },
      "payer": {
        "aliases": [
          "00210",
          "00210I",
          "00710",
          "00710D",
          "00710P",
          "10038",
          "10519",
          "1421",
          "2287",
          "2426",
          "710",
          "BBMDQ",
          "BCBSM",
          "BCMIC",
          "BCMIH",
          "BCMIV",
          "CBMI1",
          "GFXLJ",
          "MIBCN",
          "MIBCSI",
          "MIBCSP",
          "MIBLS",
          "SB710",
          "UQVGL",
          "Z1380"
        ],
        "avatarUrl": "https://prod-payer-avatars.payers.us.stedi.com/KRPCH/avatar.png?v=1762425534646",
        "coverageTypes": [
          "dental",
          "medical",
          "vision"
        ],
        "displayName": "Blue Cross Blue Shield of Michigan",
        "enrollment": {
          "ptanRequired": false,
          "transactionEnrollmentProcesses": {
            "claimPayment": {
              "timeframe": "INSTANT",
              "type": "ONE_CLICK"
            }
          }
        },
        "names": [
          "BCBSM Healthy Kids Dental (DentaQuest)",
          "Blue Care Network (BCBSM MA/BNCA - Medicare Advantage)",
          "Blue Cross Blue Shield Michigan Dental",
          "Blue Cross Blue Shield Michigan Institutional",
          "Blue Cross Blue Shield Michigan Professional",
          "Blue Cross Blue Shield of Michigan - Medicare Advantage",
          "Blue Cross Blue Shield of Michigan and Blue Care Network"
        ],
        "operatingStates": [
          "AL",
          "AK",
          "AZ",
          "AR",
          "CA",
          "CO",
          "CT",
          "DE",
          "FL",
          "GA",
          "HI",
          "ID",
          "IL",
          "IN",
          "IA",
          "KS",
          "KY",
          "LA",
          "ME",
          "MD",
          "MA",
          "MI",
          "MN",
          "MS",
          "MO",
          "MT",
          "NE",
          "NV",
          "NH",
          "NJ",
          "NM",
          "NY",
          "NC",
          "ND",
          "OH",
          "OK",
          "OR",
          "PA",
          "SC",
          "SD",
          "TN",
          "TX",
          "UT",
          "VT",
          "VA",
          "WA",
          "WI",
          "DC"
        ],
        "parentPayerGroupId": "AWOCR",
        "primaryPayerId": "00710",
        "stediId": "KRPCH",
        "transactionSupport": {
          "claimPayment": "ENROLLMENT_REQUIRED",
          "claimStatus": "SUPPORTED",
          "coordinationOfBenefits": "SUPPORTED",
          "dentalClaimSubmission": "NOT_SUPPORTED",
          "eligibilityCheck": "SUPPORTED",
          "institutionalClaimSubmission": "SUPPORTED",
          "professionalClaimSubmission": "SUPPORTED",
          "unsolicitedClaimAttachment": "NOT_SUPPORTED"
        }
      },
      "score": 2314894167592927000
    }
  ],
  "stats": {
    "total": 134,
    "transactionSupport": {
      "claimPayment": {
        "enrollmentRequired": 101,
        "notSupported": 33,
        "supported": 0
      },
      "claimStatus": {
        "enrollmentRequired": 2,
        "notSupported": 53,
        "supported": 79
      },
      "coordinationOfBenefits": {
        "enrollmentRequired": 0,
        "notSupported": 106,
        "supported": 28
      },
      "dentalClaimSubmission": {
        "enrollmentRequired": 2,
        "notSupported": 91,
        "supported": 41
      },
      "eligibilityCheck": {
        "enrollmentRequired": 6,
        "notSupported": 20,
        "supported": 108
      },
      "institutionalClaimSubmission": {
        "enrollmentRequired": 12,
        "notSupported": 32,
        "supported": 90
      },
      "professionalClaimSubmission": {
        "enrollmentRequired": 11,
        "notSupported": 23,
        "supported": 100
      },
      "unsolicitedClaimAttachment": {
        "enrollmentRequired": 0,
        "notSupported": 111,
        "supported": 23
      }
    },
    "transactionSupportCounts": {
      "claimPayment": {
        "notSupported": {
          "total": 33
        },
        "supported": {
          "enrollmentNotRequired": 0,
          "enrollmentRequired": 101,
          "total": 101
        }
      },
      "claimStatus": {
        "notSupported": {
          "total": 53
        },
        "supported": {
          "enrollmentNotRequired": 79,
          "enrollmentRequired": 2,
          "total": 81
        }
      },
      "coordinationOfBenefits": {
        "notSupported": {
          "total": 106
        },
        "supported": {
          "enrollmentNotRequired": 28,
          "enrollmentRequired": 0,
          "total": 28
        }
      },
      "dentalClaimSubmission": {
        "notSupported": {
          "total": 91
        },
        "supported": {
          "enrollmentNotRequired": 41,
          "enrollmentRequired": 2,
          "total": 43
        }
      },
      "eligibilityCheck": {
        "notSupported": {
          "total": 20
        },
        "supported": {
          "enrollmentNotRequired": 108,
          "enrollmentRequired": 6,
          "total": 114
        }
      },
      "institutionalClaimSubmission": {
        "notSupported": {
          "total": 32
        },
        "supported": {
          "enrollmentNotRequired": 90,
          "enrollmentRequired": 12,
          "total": 102
        }
      },
      "professionalClaimSubmission": {
        "notSupported": {
          "total": 23
        },
        "supported": {
          "enrollmentNotRequired": 100,
          "enrollmentRequired": 11,
          "total": 111
        }
      },
      "unsolicitedClaimAttachment": {
        "notSupported": {
          "total": 111
        },
        "supported": {
          "enrollmentNotRequired": 23,
          "enrollmentRequired": 0,
          "total": 23
        }
      }
    }
  }
}

400

{
  "code": "string",
  "message": "string"
}

401

{
  "code": "string",
  "message": "string"
}

403

{
  "code": "string",
  "message": "string"
}

404

{
  "code": "string",
  "message": "string"
}

429

{
  "code": "string",
  "message": "string"
}

500

{
  "code": "string",
  "message": "string"
}

503

{
  "code": "string",
  "message": "string"
}

504

{
  "code": "string",
  "message": "string"
}