POST
/
api
/
v0
/
mental_health
/
inquiries

Authorizations

Authorization
string
headerrequired

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
type
enum<string>
required

type of the inquiry

Available options:
CLAIMS_STATUS,
BENEFITS,
UNKNOWN
desired_completion_date
string
required

The requested completion date of the inquiry in MM-DD-YYYY format. Calls will typically be completed by the morning of the requested completion date, but in some cases may be completed earlier.

patient_name
string
required

name of the patient

dob
string
required

date of birth of the patient in MM-DD-YYYY format

member_id
string
required

member id of the patient

group_id
string

group id of the patient

insurance_in_network
boolean

whether or not the provider is in-network. If it is not known, leave this field blank and it will be determined.

npi
string
required

Ten digit NPI of the provider

tax_id
string
required

Nine digit tax id of the provider

external_id
string

An identifier which you can define and pass in with your creation request. This is useful for tracking a specific subgroup of inquiries. For instance, you can assign a unique external id to all inquiries for a specific provider on your platform.

practice_billing_address
string

The billing address of the practice. If omitted, the address will be determined from the NPI.

diagnosis_codes
string[]

Any diagnosis codes for the patient. If omitted, a general diagnosis code will be used.

claims_date_of_service
string

The date of service for the claim in MM-DD-YYYY format. Only used for claims inquiries.

claim_number
string

The claim number for the inquiry if provided by the user. Only used for claims inquiries.

insurance
required

The insurance provider for the patient.

Available options:
AETNA,
CIGNA,
HUMANA,
OPTUM,
OXFORD,
UNITED_HEALTHCARE,
UNKNOWN
benefits_query
enum<string>[]

The specific set of benefits to query. These are customized for each customer. Contact alan@healthharbor.co for details.

Available options:
DEDUCTIBLES_AND_MAXIMUMS,
PLAN_INFO,
CODE_LOOKUP_PRIOR_AUTH,
CODE_LOOKUP_BENEFITS,
REMICADE,
PULMONARY_REHAB_COVERAGE,
UNKNOWN
is_specialist
boolean

The type of provider making the inquiry. If the provider is a specialist, set this to True. If the provider is a general PCP, set this to False.

place_of_service
string

Where the service will be performed. This is typically one of a few places: the doctors office, telehealth or an ambulatory surgical center. See this page for the full list: https://www.cms.gov/medicare/coding-billing/place-of-service-codes/code-sets

billed_amount
number

The billed amount for the claim. Value should be a float with 2 decimal places. Only used for claims inquiries.

Response

200 - application/json
success
boolean
required
inquiry_id
string
required