Response Body

Code Field

All NexHealth API responses will return a boolean field named code, which will either be true or false.

  • False indicates an error processing the request and includes an error message.
  • True means the request was successful or accepted, though the response body may still be empty.

Response Format

All responses are JSON encoded. The response object is composed of the following properties:

code: Boolean value indicating the success or failure of the request.

data: Array or object containing the requested data set. It will be an Array or Object depending if you made a request to a singular resource, or the collection itself.

description: Array providing messaging about the result of the requested action.

count: Integer indicating the number of results from your request. For paginated endpoints, the count is always the total number of results, not the length of the data array in the response body.

error: Array containing an accumulation of errors which occurred during the execution of the request.


Response results always include an error property that contains error that occurred during the execution of the request. If there were no errors, the value will be an empty array.

Below you can see an example request and response with errors stating that patient and provider IDs were passed even though the endpoint /operatories does not accept those parameters. Note that the request was still successful.


curl --request GET '' \
--header 'Authorization: ********' \
--header 'Accept: application/vnd.Nexhealth+json;version=2'


    "code": true,
    "data": {
        "id": 2,
        "name": "Dr. Sarah Lexington",
        "foreign_id": "2",
        "foreign_id_type": "msg-opendental-DataSource-35",
        "rel_ids": {
            "1,Location,location_id": "1"
        "location_id": 148,
        "last_import_id": "90dff8ed-5a1e-4e86-85b1-826a15bcd753",
        "last_sync_time": null,
        "updated_at": "2020-08-12T22:42:21.444Z",
        "created_at": "2020-08-12T18:56:55.893Z",
        "display_name": "OP-2",
        "active": true,
        "static_image_url": null,
        "appt_categories": [],
        "profile_url": "",
    "description": [],
    "count": null,
    "error": [
        "Unknown parameter specified: patient_id",
        "Unknown parameter specified: provider_id"

Field Types

Below is a subset data types that can be returned in API responses.

TypeSample NameSample ValueSample JSON
stringname"Dr. Sarah Lexington"{"name":"Dr. Sarah Lexington"}


DateTime Format

All DateTime data returned by the API follows the format yyyy-MM-ddTHH:mm:ssZ. Note the Z indicating that the time zone is UTC.

e.g. "2020-08-12T22:42:21.444Z"