--- title: "Dental Inquiry Update" method: POST path: "dental_inquiry_update" --- # Dental Inquiry Update `POST dental_inquiry_update` (webhook) At the specified frequency on the subscription, we will periodically send updates on any inquiries whose statuses have changed since the last update (e.g. Scheduled --> In Progress or In Progress --> Complete). The updates will be sent in the form of a list of inquiries. Please see documentation on the Bulk Get Dental Inquiries Route for more information about the response. A size limit of 1MB is assumed, so the responses may be broken up into multiple requests if necessary. It is also suggested that the client endpoint is idempotent as the same updates may occasionally be retried in cases of network failures. ## Acknowledgement `200` Successful Response - InquirySubscriptionResponse - `subscription_id` string, required - `inquiries` union[], required - union - ExternalDentalInquiry - `id` string, required — unique generated (uuid4) id for the inquiry - `status` 'SCHEDULED' | 'IN_PROGRESS' | 'SUCCESS' | 'UNSUCCESSFUL' | 'CANCELLED' | 'UNKNOWN', required — An enumeration. - `creation_ts` string, date-time, required — timestamp of when the inquiry was created - `summary` string — summary of the call results - `results` union — The output from the call containing the benefits or claims results. - ExternalClaimsQueryResults - `call_details` CallDetails[], required — The details of the placed calls including the call time in iso format, representative name, reference number, and transcript. - … - `status` 'NOT_FOUND' | 'UNPROCESSED' | 'APPROVED' | 'DENIED', required — An enumeration. - `similar_claim_dates` string[] — Similar claim dates of service in MM-DD-YYYY format, typically when the claim was not found. - `claims_info` ExternalClaimInfo[] — Details for matching claim(s) found during the inquiry. - … - `claim_not_found_info` ExternalClaimNotFoundInfo - … - ExternalDentalEligibilityQueryResults - `call_details` CallDetails[], required — The details of the placed calls including the call time in iso format, representative name, reference number, and transcript. - … - `plan_information` PlanInformation — Coerce custom_answers values to str when loading legacy or mixed JSON. - … - `maximums` Maximums — Coerce custom_answers values to str when loading legacy or mixed JSON. - … - `treatment_history` object — The treatment history for the patient. The keys are dates in MM-DD-YYYY format and the values are a list of procedure codes performed on that date. See examples for more information. - `procedure_classes` object — A dict that maps from the different classes of procedures to their benefits. If a class is not covered, it may not have any other fields. See examples for more information. - `procedure_codes` array[] — A list that contains information from the different procedure codes and the requested benefits information for that code. See examples for more information. - … - `extra_info` ExtraDentalInfo — Coerce custom_answers values to str when loading legacy or mixed JSON. - … - `request` ExternalDentalInquiryRequest, required - `type` 'CLAIMS_STATUS' | 'BENEFITS' | 'UNKNOWN', required — An enumeration. - `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 — (deprecated, use billing_npi and rendering_npi instead) Ten digit NPI of the provider - `billing_npi` string — Ten digit NPI of the billing provider - `rendering_npi` string — Ten digit NPI of the rendering 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. - `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. - `call_script_id` string — Optional ID of a call script belonging to your team. Use for eligibility/benefits inquiries to control which questions are asked. You can find call script IDs on the Accounts page in the dashboard. When provided, it must be a script your team created. For eligibility search, either benefits queries or this field may satisfy the requirement—see Health Harbor documentation. - `insurance` 'AETNA' | 'HEALTHPLEX' | 'HUMANA' | 'METLIFE' | 'UNITED_HEALTHCARE' | 'UNKNOWN' — An enumeration. - `benefits_query` ExternalDentalEligibilitySearchQuery[] — The benefits queries for the inquiry if provided by the user. Can be either a pre-defined set of questions (e.g. STANDARD for returning patients) or an ad-hoc defined set of codes. - `benefits_codes` string[] — Codes processed for a CODE_LOOKUP_BENEFITS or a CODE_LOOKUP_PRIOR_AUTH benefits inquiry. The first character in the CDT codes (D) can be optionally omitted. - `is_specialist` boolean — The type of provider making the inquiry. If the provider is a specialist (e.g. periodontist, oral surgeon), set this to True. If the provider is a dentist, set this to False. Defaults to False if not provided. - `insurance_payor_id` string — The payor id for the insurance. Usually five characters. For example, one payor id for Aetna is 60054. - ExternalMedicalInquiry - `id` string, required — unique generated (uuid4) id for the inquiry - `status` 'SCHEDULED' | 'IN_PROGRESS' | 'SUCCESS' | 'UNSUCCESSFUL' | 'CANCELLED' | 'UNKNOWN', required — An enumeration. - `creation_ts` string, date-time, required — timestamp of when the inquiry was created - `summary` string — summary of the call results - `results` union — The output from the call containing the benefits or claims results. - ExternalClaimsQueryResults - `call_details` CallDetails[], required — The details of the placed calls including the call time in iso format, representative name, reference number, and transcript. - … - `status` 'NOT_FOUND' | 'UNPROCESSED' | 'APPROVED' | 'DENIED', required — An enumeration. - `similar_claim_dates` string[] — Similar claim dates of service in MM-DD-YYYY format, typically when the claim was not found. - `claims_info` ExternalClaimInfo[] — Details for matching claim(s) found during the inquiry. - … - `claim_not_found_info` ExternalClaimNotFoundInfo - … - ExternalMedicalEligibilityQueryResults - `call_details` CallDetails[], required — The details of the placed calls including the call time in iso format, representative name, reference number, and transcript. - … - `plan_information` PlanInformation — Coerce custom_answers values to str when loading legacy or mixed JSON. - … - `maximums` Maximums — Coerce custom_answers values to str when loading legacy or mixed JSON. - … - `procedure_classes` object — A dict that maps from the different categories of procedures to their benefits. Categories will contain prior auth, deductibles, copay amounts, coinsurance percentages and any frequency limitations. See examples for more information - `procedure_codes` array[] — A list that contains a tuple of procedure code information and their benefits. For medical, procedure codes, if covered, will contain deductible information, copays, coinsurance, frequency limitations and whether or not prior authorization is needed. Coinsurance refers to the patient's portion of the payment. - … - `extra_info` ExtraMedicalInfo — Coerce custom_answers values to str when loading legacy or mixed JSON. - … - `request` ExternalMedicalInquiryRequest, required - `type` 'CLAIMS_STATUS' | 'BENEFITS' | 'UNKNOWN', required — An enumeration. - `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 — (deprecated, use billing_npi and rendering_npi instead) Ten digit NPI of the provider - `billing_npi` string — Ten digit NPI of the billing provider - `rendering_npi` string — Ten digit NPI of the rendering 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. - `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. - `call_script_id` string — Optional ID of a call script belonging to your team. Use for eligibility/benefits inquiries to control which questions are asked. You can find call script IDs on the Accounts page in the dashboard. When provided, it must be a script your team created. For eligibility search, either benefits queries or this field may satisfy the requirement—see Health Harbor documentation. - `insurance` string — The insurance provider for the patient. You must provide the name of the insurance provider or the payor id in order for the insurance to be identified. - `benefits_query` ExternalMedicalEligibilitySearchQuery[] — The specific set of benefits to query. These are customized for each customer. Contact alan@healthharbor.co for details. - `benefits_codes` string[] — Codes processed for a CODE_LOOKUP_BENEFITS or a CODE_LOOKUP_PRIOR_AUTH benefits inquiry. - `benefits_form_name` string — The name of a custom form for your providers. Contact alan@healthharbor.co for details. - `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 - `billed_amount` number — The billed amount for the claim. Value should be a float with 2 decimal places. Only used for claims inquiries. - `insurance_payor_id` string — The payor id for the insurance. Usually five characters. For example, one payor id for Aetna is 60054. You must provide the name of the insurance provider or the payor id in order for the insurance to be identified. - `insurance_phone_number` string — The phone number used for identifying the insurance. This is optional, but highly recommended as it helps identify the provider more accurately in the cases of third party administrators (TPAs). - ExternalMentalHealthInquiry - `id` string, required — unique generated (uuid4) id for the inquiry - `status` 'SCHEDULED' | 'IN_PROGRESS' | 'SUCCESS' | 'UNSUCCESSFUL' | 'CANCELLED' | 'UNKNOWN', required — An enumeration. - `creation_ts` string, date-time, required — timestamp of when the inquiry was created - `summary` string — summary of the call results - `results` union — The output from the call containing the benefits or claims results. - ExternalClaimsQueryResults - `call_details` CallDetails[], required — The details of the placed calls including the call time in iso format, representative name, reference number, and transcript. - … - `status` 'NOT_FOUND' | 'UNPROCESSED' | 'APPROVED' | 'DENIED', required — An enumeration. - `similar_claim_dates` string[] — Similar claim dates of service in MM-DD-YYYY format, typically when the claim was not found. - `claims_info` ExternalClaimInfo[] — Details for matching claim(s) found during the inquiry. - … - `claim_not_found_info` ExternalClaimNotFoundInfo - … - ExternalMentalHealthEligibilityQueryResults - `call_details` CallDetails[], required — The details of the placed calls including the call time in iso format, representative name, reference number, and transcript. - … - `plan_information` PlanInformation — Coerce custom_answers values to str when loading legacy or mixed JSON. - … - `maximums` Maximums — Coerce custom_answers values to str when loading legacy or mixed JSON. - … - `procedure_codes` array[] — A list that contains a tuple of procedure code information and their benefits. For mental health, procedure codes, if covered, will contain deductible information, copays, coinsurance, frequency limitations and whether or not prior authorization is needed. Coinsurance refers to the patient's portion of the payment. - … - `extra_info` ExtraMedicalInfo — Coerce custom_answers values to str when loading legacy or mixed JSON. - … - `request` ExternalMentalHealthInquiryRequest, required - `type` 'CLAIMS_STATUS' | 'BENEFITS' | 'UNKNOWN', required — An enumeration. - `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 — (deprecated, use billing_npi and rendering_npi instead) Ten digit NPI of the provider - `billing_npi` string — Ten digit NPI of the billing provider - `rendering_npi` string — Ten digit NPI of the rendering 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. - `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. - `call_script_id` string — Optional ID of a call script belonging to your team. Use for eligibility/benefits inquiries to control which questions are asked. You can find call script IDs on the Accounts page in the dashboard. When provided, it must be a script your team created. For eligibility search, either benefits queries or this field may satisfy the requirement—see Health Harbor documentation. - `insurance` string — The insurance provider for the patient. You must provide the name of the insurance provider or the payor id in order for the insurance to be identified. - `benefits_query` ExternalMentalHealthEligibilitySearchQuery[] — The specific set of benefits to query. These are customized for each customer. Contact alan@healthharbor.co for details. - `benefits_codes` string[] — Codes processed for a CODE_LOOKUP_BENEFITS or a CODE_LOOKUP_PRIOR_AUTH benefits inquiry. - `benefits_form_name` string — The name of a custom form for your providers. Contact alan@healthharbor.co for details. - `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. - `insurance_payor_id` string — The payor id for the insurance. Usually five characters. For example, one payor id for Aetna is 60054. - `message_hash` string --- [API](https://skmtc.net/healthharbor/apis/health-harbor.md) · [All operations](https://skmtc.net/healthharbor/apis/health-harbor/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/healthharbor/health-harbor/revisions/f1047899ad24/schema)