Skip to main content
GET
/
v1
/
discovery
/
{discoveryId}
Get Discovery
curl --request GET \
  --url https://api.soharhealth.com/v1/discovery/{discoveryId} \
  --header 'Authorization: Bearer <token>'
{
  "status": "complete",
  "discoveryId": "fb701ac1-1246-4860-b1ec-bd916b97a990",
  "payerId": "62308",
  "payerName": "Cigna",
  "memberId": "00000000",
  "firstName": "JOHN",
  "lastName": "DOE",
  "dateOfBirth": "09/20/2023",
  "state": "CA",
  "id": "123456"
}

Authorizations

​
Authorization
string
header
required

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

Response

A discovery

​
status
enum<string>
required

The status of the discovery request

Available options:
complete,
pending
​
discoveryId
string<uuid>
required

The Sohar ID for the discovery

Example:

"fb701ac1-1246-4860-b1ec-bd916b97a990"

​
payerId
string<uuid>

The payer ID. A null value will be returned if the status field is pending, or if the status field is complete and the discovery request was unsuccessful

Example:

"62308"

​
payerName
string

The payer's name. A null value will be returned if the status field is pending, or if the status field is complete and the discovery request was unsuccessful

Example:

"Cigna"

​
memberId
string

The insurance member ID. A null value will be returned if the status field is pending, or if the status field is complete and the discovery request was unsuccessful

Example:

"00000000"

​
firstName
string

The patient's first name

Example:

"JOHN"

​
lastName
string

The patient's last name

Example:

"DOE"

​
dateOfBirth
string

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

Example:

"09/20/2023"

​
state
enum<string>

The patient's state

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"

​
id
string | null

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

Example:

"123456"

⌘I