Skip to main contentA 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 and look up a specific payer with 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; these are alternative identifiers used by other systems that map to the same payer in Sohar.
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 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. 
