> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soharhealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Payers

A payer is the insurance organization responsible for adjudicating a patient's benefits. In Sohar, payers are represented by a stable `payerId` and a human-friendly `payerName`. You can retrieve the payer list with [Get Payers](/api-reference/payers/get-payers) and look up a specific payer with [Get Payer](/api-reference/payers/get-payer).

## Payer IDs and aliases

Payer IDs are the identifiers Sohar expects in API requests. If an input payer is incorrect, Sohar may resolve it to the correct payer and return the corrected `payerId` and `payerName` in the response. Some payers also have alias IDs and alias names; these are alternative identifiers and payer names used by other systems that map to the same payer in Sohar. The Get Payers and Get Payer APIs return these as `aliasPayerIds` and `aliasPayerNames`.

## Group Payers

Group Payers are a Sohar concept that roll up related payer IDs under a single parent grouping. This is useful when a payer operates multiple regional plans, product lines, or legacy brands that you want to manage together.

Each Group Payer has a Group ID, listed in the Sohar dashboard in the Payers view. For example, the Group ID for Medicaid is `SH03D959`.

Group IDs can be used with the [Create Verification V2](/api-reference/verifications/create-verification-v2) API instead of `payerId`. Sohar will automatically route the request to the correct Sohar payer.

* Use Group Payers when the patient indicates a broad payer (for example “Medicaid”) but the regional payer is unclear.
* When available, prefer a specific `payerId` for the patient’s coverage to avoid ambiguity.

If you need help mapping payer IDs to a Group Payer, reach out to Sohar support.