v1

latestOpenAPI 3.0.0NexHealth License 1.02026-07-2688180386.6 KB
Insurance

View insurance coverages

This endpoint returns a list of insurance coverages. All filters are optional: without any filters, every active insurance coverage for the institution is returned. Only active coverages are included by default; pass active=false to list inactive coverages instead.

get/insurance_coverages

Query parameters

subdomainstring required

Used to scope the request to the specified institution

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.

updated_sincestring date-time

Insurance coverages updated at or after the specified time (UTC). The comparison is inclusive and matches when either the coverage or its subscription was updated since the given time

patient_idinteger

Filter for coverages of a specific patient. Responds with a 404 when no patient with this id exists

activeboolean

Filter active (true) or inactive (false) insurance coverages. Defaults to true, so inactive coverages are only returned when this is explicitly set to false

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": 18,
      "subscription_relation": "self",
      "patient_id": 25,
      "priority": 2,
      "plan_id": 18,
      "subscriber_num": "123456789",
      "effective_date": "2022-01-01",
      "expiration_date": "2022-12-31",
      "insurance_type": "dental",
      "updated_at": "2020-06-05T20:16:57.007Z",
      "active": true
    }
  ],
  "page_info": {
    "has_previous_page": false,
    "has_next_page": false,
    "start_cursor": "AAAAA",
    "end_cursor": "BBBBBB"
  }
}