Create Verifications V1

curl --request POST \
  --url https://api.soharhealth.com/v1/verifications/batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "verifications": [
    {
      "firstName": "John",
      "lastName": "Doe",
      "dateOfBirth": "09/20/2023",
      "state": "CA",
      "memberId": "00000000",
      "payerId": "62308",
      "npi": "0123456789",
      "taxonomyCode": "2084P0800X",
      "placeOfService": "02",
      "id": "123456",
      "subscriber": {
        "firstName": "<string>",
        "lastName": "<string>",
        "dateOfBirth": "09/20/2023"
      }
    }
  ]
}
'

{
  "results": [
    {
      "status": 201,
      "patientId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "verificationId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "error": "invalid_request_error",
      "param": "memberId",
      "id": "123456"
    }
  ]
}

POST

verifications

batch

Create Verifications V1

curl --request POST \
  --url https://api.soharhealth.com/v1/verifications/batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "verifications": [
    {
      "firstName": "John",
      "lastName": "Doe",
      "dateOfBirth": "09/20/2023",
      "state": "CA",
      "memberId": "00000000",
      "payerId": "62308",
      "npi": "0123456789",
      "taxonomyCode": "2084P0800X",
      "placeOfService": "02",
      "id": "123456",
      "subscriber": {
        "firstName": "<string>",
        "lastName": "<string>",
        "dateOfBirth": "09/20/2023"
      }
    }
  ]
}
'

{
  "results": [
    {
      "status": 201,
      "patientId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "verificationId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "error": "invalid_request_error",
      "param": "memberId",
      "id": "123456"
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

verifications

object[]

required

Show child attributes

verifications.firstName

string

required

The patient's first name

Example:

"John"

verifications.lastName

string

required

The patient's last name

Example:

"Doe"

verifications.dateOfBirth

string

required

The patient's birth date in MM/DD/YYYY format

Example:

"09/20/2023"

verifications.state

enum<string>

required

Two-letter US state code

Available options:

AK,

AL,

AR,

AZ,

CA,

CO,

CT,

DC,

DE,

FL,

GA,

HI,

IA,

ID,

IL,

IN,

KS,

KY,

LA,

MA,

MD,

ME,

MI,

MN,

MO,

MS,

MT,

NC,

ND,

NE,

NH,

NJ,

NM,

NV,

NY,

OH,

OK,

OR,

PA,

RI,

SC,

SD,

TN,

TX,

UT,

VA,

VT,

WA,

WI,

WV,

WY

Example:

"CA"

verifications.memberId

string

required

The insurance member ID

Example:

"00000000"

verifications.payerId

string<uuid>

required

The payer ID. See the Sohar payer list

Example:

"62308"

verifications.npi

string

required

An NPI to identify the provider requesting benefits, typically a type 2 NPI

Example:

"0123456789"

verifications.taxonomyCode

string

An optional taxonomy code to override the primary taxonomy code associated with the provider's NPI number

Example:

"2084P0800X"

verifications.placeOfService

string

An optional two-digit code that describes the setting in which a service was provided

Example:

"02"

verifications.id

string

An optional identifier for the verification

Maximum string length: 45

Example:

"123456"

verifications.subscriber

object

An optional object to describe the subscriber related to the insurance member ID. Used when the patient is a dependent - the subscriber is typically a parent or spouse

Show child attributes

verifications.subscriber.firstName

string

The subscriber's first name

verifications.subscriber.lastName

string

The subscriber's last name

verifications.subscriber.dateOfBirth

string

The subscriber's birth date in MM/DD/YYYY format

Example:

"09/20/2023"

Response

An array of results

results

object[]

Show child attributes

results.status

number

An HTTP status code for the request

Example:

201

results.patientId

string<uuid>

A Sohar ID for the patient if the request was successful

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

results.verificationId

string<uuid>

A Sohar ID for the verification if the request was successful

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

results.error

string

An error message if the request was unsuccessful

Example:

"invalid_request_error"

results.param

string

The parameter that was invalid in the request, if the request was unsuccessful

Example:

"memberId"

results.id

string | null

An optional identifier for the verification. This is a user-defined value that can be used when creating the verification

Example:

"123456"

Create Verification Get Verification V1

⌘I

API Reference

Auth

Verification

Discovery

Network Status

Cost Estimation

Payers

Providers

Webhooks

Legacy Endpoints

Create Verifications V1

Authorizations

Body

Response