Verifications are a core concept of the Sohar platform. A Verification represents a request for eligibility status and benefits information for a given patient.

Providers

A National Provider Identifier (NPI) is a unique 10-digit number assigned to healthcare providers in the U.S. There are two types of NPIs relevant here: Type 1 (rendering provider), which identifies the individual delivering care (e.g., a doctor), and Type 2 (group provider), which identifies the organization or practice (e.g., a clinic).

Some payers require an NPI for a credentialed provider in order to return patient data. Depending on the payer, this may be a Type 1 or Type 2 NPI. If a required NPI is missing, the request will fail with an error.payer.npi response.

Sohar handles this complexity automatically using the providers enrolled in your account. To avoid provider-related errors, make sure your providers are enrolled - either through the dashboard or programmatically using the Create Provider API.

Statuses

StatusDescription
complete.eligibleThe verification was successfully completed; Patient is confirmed active coverage and covered for the provided taxonomy code.
complete.ineligibleThe verification was successfully completed; Patient is either inactive and/or not covered for the provided taxonomy code.
error.member.idThe member ID was not recognized by the payer, or a different payer ID should be used.
error.member.dobThe patient’s date of birth was not recognized by the payer, or a different payer ID should be used.
error.member.nameThe patient’s name was not recognized by the payer, or a different payer ID should be used. This is often due to incorrect spelling or nicknames.
error.payerThe payer has been unavailable for over 24 hours and the Sohar Operations team has been unable to resolve the verification via payer portal or phone call.
error.payer.npiThe provided NPI is not recognized by the payer. Some payers require an NPI on file in order to provide benefits. Some payers require a rendering NPI in order to provide benefits, for example Blue Cross Blue Shield of Texas.
pendingThe verification could not be resolved immediately, typically because the payer API was unavailable. A verification with this status will be followed by one of the statuses listed above.

Sandbox Values

Use the following payerId and memberId values in the sandbox environment for predefined responses.

Payer IDMember IDStatus
6005400000000complete.eligible
6005400000001complete.ineligible
6005410000000error.member.id
6005410000001error.member.dob
6005410000002error.member.name
OSCARerror.payer.npi
06111pending