POST
/
api
/
v0
/
medical
/
inquiries

Authorizations

Authorization
string
header
required

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

Body

application/json
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.

dob
string
required

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

insurance
required

The insurance provider for the patient.

Available options:
AETNA,
HUMANA,
OPTUM,
OXFORD,
UNITED_HEALTHCARE,
UNKNOWN
member_id
string
required

member id of the patient

npi
string
required

Ten digit NPI of the provider

patient_name
string
required

name of the patient

tax_id
string
required

Nine digit tax id of the provider

type
enum<string>
required

type of the inquiry

Available options:
CLAIMS_STATUS,
BENEFITS,
UNKNOWN
additional_info
string

Any additional information about the inquiry that is not covered by the other fields. This can be used to pass in any additional information for the request. Please check with the Health Harbor team before using this field as it may not be incorporated into the inquiry unless we are already aware of it.

benefits_codes
string[]

Codes processed for a CODE_LOOKUP_BENEFITS or a CODE_LOOKUP_PRIOR_AUTH benefits inquiry.

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,
NETWORK_STATUS,
CODE_LOOKUP_PRIOR_AUTH,
CODE_LOOKUP_BENEFITS,
PULMONARY_REHAB_COVERAGE,
PRIOR_AUTH_PHYSICAL_THERAPY,
WEIGHT_MANAGEMENT,
UNKNOWN
billed_amount
number

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

claim_number
string

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

claims_date_of_service
string

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

diagnosis_codes
string[]

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

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.

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.

insurance_phone_number
string

The phone number used for identifying the insurance

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 or telehealth See this page for the full list: https://www.cms.gov/medicare/coding-billing/place-of-service-codes/code-sets

practice_billing_address
string

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

Response

200 - application/json
inquiry_id
string
required
success
boolean
required