GET
/
payers
/
search
cURL
curl --request GET \
  --url https://healthcare.us.stedi.com/2024-04-01/payers/search \
  --header 'Authorization: <api-key>'
{
  "items": [
    {
      "payer": {
        "stediId": "KRPCH",
        "displayName": "Blue Cross Blue Shield of Michigan",
        "primaryPayerId": "00710",
        "aliases": [
          "00210I",
          "00710",
          "00710D",
          "00710P",
          "1421",
          "2287",
          "2426",
          "710",
          "CBMI1",
          "MIBCSI",
          "MIBCSP",
          "SB710",
          "Z1380"
        ],
        "names": [
          "Blue Cross Blue Shield Michigan Dental",
          "Blue Cross Blue Shield Michigan Institutional",
          "Blue Cross Blue Shield Michigan Professional"
        ],
        "transactionSupport": {
          "eligibilityCheck": "SUPPORTED",
          "claimStatus": "SUPPORTED",
          "claimPayment": "ENROLLMENT_REQUIRED",
          "dentalClaimSubmission": "NOT_SUPPORTED",
          "professionalClaimSubmission": "SUPPORTED",
          "institutionalClaimSubmission": "SUPPORTED",
          "coordinationOfBenefits": "SUPPORTED",
          "unsolicitedClaimAttachment": "NOT_SUPPORTED"
        },
        "enrollment": {
          "ptanRequired": false,
          "transactionEnrollmentProcesses": {
            "claimPayment": {
              "type": "ONE_CLICK"
            }
          }
        },
        "parentPayerGroupId": "AWOCR"
      },
      "score": 11.279371,
      "matches": {
        "stediId": "<b>KRP</b>CH",
        "displayName": "<b>Blue Cross Blue</b> Shield of Michigan",
        "aliases": [
          "<b>00710</b>"
        ],
        "names": [
          "<b>Blue Cross Blue</b> Shield Michigan Dental",
          "<b>Blue Cross Blue</b> Shield Michigan Institutional",
          "<b>Blue Cross Blue</b> Shield Michigan Professional"
        ]
      }
    }
  ],
  "stats": {
    "total": 100,
    "transactionSupport": {
      "eligibilityCheck": {
        "supported": 87,
        "notSupported": 8,
        "enrollmentRequired": 5
      },
      "claimStatus": {
        "supported": 92,
        "notSupported": 3,
        "enrollmentRequired": 5
      },
      "professionalClaimSubmission": {
        "supported": 85,
        "notSupported": 10,
        "enrollmentRequired": 5
      },
      "institutionalClaimSubmission": {
        "supported": 75,
        "notSupported": 15,
        "enrollmentRequired": 10
      },
      "claimPayment": {
        "supported": 45,
        "notSupported": 20,
        "enrollmentRequired": 35
      },
      "coordinationOfBenefits": {
        "supported": 65,
        "notSupported": 25,
        "enrollmentRequired": 10
      },
      "dentalClaimSubmission": {
        "supported": 70,
        "notSupported": 20,
        "enrollmentRequired": 10
      },
      "unsolicitedClaimAttachment": {
        "supported": 55,
        "notSupported": 35,
        "enrollmentRequired": 10
      }
    },
    "transactionSupportCounts": {
      "eligibilityCheck": {
        "supported": {
          "enrollmentRequired": 5,
          "enrollmentNotRequired": 87,
          "total": 92
        },
        "notSupported": {
          "total": 8
        }
      },
      "claimStatus": {
        "supported": {
          "enrollmentRequired": 5,
          "enrollmentNotRequired": 92,
          "total": 97
        },
        "notSupported": {
          "total": 3
        }
      },
      "professionalClaimSubmission": {
        "supported": {
          "enrollmentRequired": 5,
          "enrollmentNotRequired": 85,
          "total": 90
        },
        "notSupported": {
          "total": 10
        }
      },
      "institutionalClaimSubmission": {
        "supported": {
          "enrollmentRequired": 10,
          "enrollmentNotRequired": 75,
          "total": 85
        },
        "notSupported": {
          "total": 15
        }
      },
      "claimPayment": {
        "supported": {
          "enrollmentRequired": 35,
          "enrollmentNotRequired": 45,
          "total": 80
        },
        "notSupported": {
          "total": 20
        }
      },
      "coordinationOfBenefits": {
        "supported": {
          "enrollmentRequired": 10,
          "enrollmentNotRequired": 65,
          "total": 75
        },
        "notSupported": {
          "total": 25
        }
      },
      "dentalClaimSubmission": {
        "supported": {
          "enrollmentRequired": 10,
          "enrollmentNotRequired": 70,
          "total": 80
        },
        "notSupported": {
          "total": 20
        }
      },
      "unsolicitedClaimAttachment": {
        "supported": {
          "enrollmentRequired": 10,
          "enrollmentNotRequired": 55,
          "total": 65
        },
        "notSupported": {
          "total": 35
        }
      }
    }
  }
}
This is a beta endpoint. We may make backwards incompatible changes.
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. In the stats object, the summary counts of payers matching the search criteria are fewer than the summary counts for the basic search. This is because the 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 (Blue Cross Blue Shield of Michigan).

Authorizations

​
Authorization
string
header
required

A Stedi API Key for authentication.

Query Parameters

​
pageSize
number

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

Required range: 10 <= x <= 100
​
pageToken
string

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.

Required string length: 1 - 1024
​
query
string

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
enum<string>

Filter for matching payers with the specified 270 eligibility checks support. When combined with other transaction filters, payers must satisfy all specified criteria to be included in results.

Available options:
SUPPORTED,
NOT_SUPPORTED,
ENROLLMENT_REQUIRED,
EITHER
​
claimStatus
enum<string>

Filter for matching payers with the specified 276/277 real-time claim status checks support. When combined with other transaction filters, payers must satisfy all specified criteria to be included in results.

Available options:
SUPPORTED,
NOT_SUPPORTED,
ENROLLMENT_REQUIRED,
EITHER
​
professionalClaimSubmission
enum<string>

Filter for matching payers with the specified 837 professional claims support. When combined with other transaction filters, payers must satisfy all specified criteria to be included in results.

Available options:
SUPPORTED,
NOT_SUPPORTED,
ENROLLMENT_REQUIRED,
EITHER
​
dentalClaimSubmission
enum<string>

Filter for matching payers with the specified 837 dental claims support. When combined with other transaction filters, payers must satisfy all specified criteria to be included in results.

Available options:
SUPPORTED,
NOT_SUPPORTED,
ENROLLMENT_REQUIRED,
EITHER
​
institutionalClaimSubmission
enum<string>

Filter for matching payers with the specified 837 institutional claims support. When combined with other transaction filters, payers must satisfy all specified criteria to be included in results.

Available options:
SUPPORTED,
NOT_SUPPORTED,
ENROLLMENT_REQUIRED,
EITHER
​
claimPayment
enum<string>

Filter for matching payers with the specified 835 Electronic Remittance Advice (ERA) support. When combined with other transaction filters, payers must satisfy all specified criteria to be included in results.

Available options:
SUPPORTED,
NOT_SUPPORTED,
ENROLLMENT_REQUIRED,
EITHER
​
coordinationOfBenefits
enum<string>

Filter for matching payers with the specified coordination of benefits (COB) checks support. When combined with other transaction filters, payers must satisfy all specified criteria to be included in results.

Available options:
SUPPORTED,
NOT_SUPPORTED,
ENROLLMENT_REQUIRED,
EITHER
​
unsolicitedClaimAttachment
enum<string>

Filter for matching payers with the specified unsolicited 275 claim attachments support. When combined with other transaction filters, payers must satisfy all specified criteria to be included in results.

Available options:
SUPPORTED,
NOT_SUPPORTED,
ENROLLMENT_REQUIRED,
EITHER
​
coverageTypes
enum<string>[]

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

Response

200
application/json

SearchPayers 200 response

Common output structure for list operations with pagination support.