CirrusMD API Documentation

Repository for GiHub Pages hosted Developer Documentation

Get Non-Billable Clinical Documentation Notes

This endpoint retrieves all of your Non-Billable Clinical Documentation Notes. Unlike Progress Notes, these notes are NOT tied to a patient encounter. However, these notes are often associated with Progress Notes. As such, the response shape matches that of the Progress Notes endpoint. Some Progress-Note-specific fields are always null or default to a static value.

NOTE

Replace <base_url> from the examples below with one of the following:

Environment Base URL
Production https://api.cirrusmd.com
Sandbox https://api-sandbox.cirrusmd.com

Request URL

GET <base_url>/v2/non_billable_notes

Optional Query Parameters

Parameter Description
starts_at (optional) completed_at Timestamp from which to begin filtered results. If omitted, the default starts_at will be 1 hour in the past.
ends_at (optional) completed_at Timestamp from which to end filtered results. If omitted, the default ends_at will be the current time.
page (optional) The page number to fetch notes from. (Each page contains 100 Non-Billable Clinical Documentation Notes)

Example Request

curl "<base_url>/v2/non_billable_notes" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json"

Example Response

{
  "links":{
    "self":"<base_url>/v2/non_billable_notes",
    "prev":null,
    "next":null
  },
  "meta":{
    "paging":{
      "total":1
    }
  },
  "data":[
    {
      "id":5,
      "body":"I determined that the patient has strep throat and wrote a prescription for an antibiotic. The patient has been instructed to reach back out if their condition changes.",
      "communication_channels":[
        "messaging"
      ],
      "completed_at":"2016-10-03T20:11:30Z",
      "created_at":"2016-10-03T20:11:30Z",
      "encounter_created_at": null,
      "encounter_duration": 0,
      "encounter_id": null,
      "icd_codes":[],
      "membership":{
        "id":3,
        "email":"jane@patient.com",
        "member_id":null,
        "state":"active",
        "type":"memberships",
        "patient":{
          "address":null,
          "dob":"2005-01-11T00:00:00Z",
          "external_id":null,
          "first_name":"Jane",
          "gender":"female",
          "id":3,
          "last_name":"Patient",
          "middle_name":null,
          "phone":null,
          "primary_care_physician":null,
          "type":"patients",
          "zipcode":"80202"
        },
        "metadata":{
          "referring_hospital":"St Vincents"
        },
        "plan":{
          "id":7,
          "active":true,
          "created_at":"2016-09-28T23:33:32Z",
          "description":"Urgent Care",
          "external_id":"hijklm",
          "name":"Plan 1",
          "provider_group":{
            "id":2,
            "created_at":"2016-09-28T23:33:32Z",
            "external_id":null,
            "name":"Family Practice",
            "type":"provider_groups"
          },
          "type":"plans"
        }
      },
      "provider":{
        "id":1,
        "type":"providers",
        "first_name":"Jann",
        "last_name":"Vincent",
        "provider_identifier":null
      },
      "resolution_tags":[],
      "type":"non_billable_note"
    }...
  ]
}

Response Properties

Field Description
id Non-Billable Clinical Documentation Note ID
body Non-Billable Clinical Documentation Note body
completed_at Timestamp in which Non-Billable Clinical Documentation Note was completed
communication_channels Always ["messaging"]
created_at Non-Billable Clinical Documentation Note Created At Timestamp
encounter_created_at Always null
encounter_duration Always 0
encounter_id Always null
icd_codes Always []
membership Membership Object
provider Provider Object
resolution_tags Always []
type Resource Type

All dates will follow the common ISO 8601 date and time standard format, and will be expressed in UTC: YYYY-MM-DDThh:mm:ssZ