NEnexhealth
Charges

View charges (beta)

🚧 Beta

Send Nex-Api-Version: v3.1.0 to use this endpoint. It is still changing, and access is limited to approved partner institutions. Contact NexHealth before you build on it.

Changed from v3.0.0: Adds query param charged_since.

This endpoint returns ledger charges for the specified location; at least one of provider_id, patient_id, procedure_id, guarantor_id, updated_since, or charged_since must be provided.

get/charges

Request

  • Base URL
    https://nexhealth.info
  • URL
    https://nexhealth.info/charges
  • Auth
    API key in header Authorization

Query parameters

subdomainstring required

Used to scope the request to the specified institution

location_idinteger required

Used to scope the request to the specified location

patient_idinteger

Filter by patient

provider_idinteger

Filter by provider

procedure_idinteger

Filter by procedure

guarantor_idinteger

Filter by guarantor

updated_sincestring date-time

Charges updated after the specified time (UTC)

charged_sincestring date-time

Charges with charged_at after the specified time (UTC)

include_deletedboolean

Include deleted charges

sortstring

Optional comma-separated string of fields to sort on. Include a leading dash for descending order.

Available fields:

  • charged_at
  • -charged_at
  • updated_at
  • -updated_at
start_cursorstring

First item of the current page. Starts empty

end_cursorstring

Last item of the current page. Starts empty

per_pageinteger

Number of results to return per page. Maximum allowed amount is 1000.

include[]string[]

Resources to be included in the response

Headers

Nex-Api-Versionstring required

The NexHealth API version

Response

Successful

codeboolean

Indicates the success or failure of the request

descriptionstring

Additional context on the request to help with debugging.

errorstring[]

Any errors that occur during the execution of the request.

page_infoobject

Pagination information that can be used for fetching previous and next pages.

Example response

{
  "description": "Description",
  "error": [
    "Error message"
  ],
  "data": [
    {
      "id": 113,
      "foreign_id": "1234-5678",
      "location_id": 10,
      "patient_id": 3,
      "guarantor_id": 5,
      "provider_id": 15,
      "procedure_id": 34,
      "procedure_code": "D0120",
      "updated_at": "2024-09-05T20:31:17.007Z",
      "description": "This is a description",
      "fee": {
        "amount": "62.00",
        "currency": "USD"
      },
      "charged_at": "2024-10-05",
      "deleted_at": "2022-01-01T00:00:00Z",
      "claim_payouts": [
        {
          "amount_billed_to_insurance": {
            "amount": "62.00",
            "currency": "USD"
          },
          "estimated_insurance_payment": {
            "amount": "62.00",
            "currency": "USD"
          },
          "insurance_payment": {
            "amount": "62.00",
            "currency": "USD"
          },
          "write_off": {
            "amount": "62.00",
            "currency": "USD"
          },
          "allowed_amount": {
            "amount": "62.00",
            "currency": "USD"
          },
          "fee_schedule_procedure_code": {
            "procedure_code_id": "ab123456-11aa-99ff-a111-d1ee12345678",
            "fee": {
              "amount": "62.00",
              "currency": "USD"
            },
            "code": "D0120",
            "id": 113,
            "location_id": 10,
            "fee_schedule_id": 1234,
            "updated_at": "2020-06-05T20:16:57.007Z"
          },
          "claim_id": 1234
        }
      ]
    }
  ],
  "page_info": {
    "has_previous_page": false,
    "has_next_page": false,
    "start_cursor": "AAAAA",
    "end_cursor": "BBBBBB"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.