Fee schedules

Before you start

NexHealth reads financial data from the health record system only on request. To turn it on for your API key, email [email protected]. Sandbox locations have it on.
Every request needs a bearer token from POST /authenticates. See Authentication.
Requests take the practice's subdomain and, for most endpoints, a location_id. See Institutions, syncs, and locations.

Overview

Fee schedules are the prices a practice charges for procedures. They set the amount that appears on a patient's ledger when the practice adds a procedure. Practices usually have several fee schedules: a default cash schedule, and one for each insurance provider they work with.

Each procedure in the health record system can have one or more fee schedule entries. Each entry gives the cost of that procedure under one fee schedule. When the practice creates a charge, the system looks up the procedure code and the fee schedule that applies to find the amount.

Example use cases

Use the fee schedules endpoint to get procedure prices before you submit a treatment plan. This gives patients accurate cost estimates up front.
Use fee schedule data to calculate how expected patient costs differ by insurance plan and membership plan.

Fee schedule procedures response

{
  "code": true,
  "description": null,
  "error": null,
  "data": [
    {
      "id": 113,
      "name": "Cash",
      "active": true,
      "location_id": 0,
      "updated_at": "2020-06-05T20:16:57.007Z",
      "procedure_fees": [
        {
          "procedure_code_id": "ab123456-11aa-99ff-a111-d1ee12345678",
          "fee": {
            "amount": "62.00",
            "currency": "USD"
          }
        }
      ]
    }
  ],
  "page_info": {
    "has_previous_page": false,
    "has_next_page": false,
    "start_cursor": "AAAAA",
    "end_cursor": "BBBBBB"
  }
}