Skip to main content
GET
/
user
/
patient
/
{patient_id}
Get Patient
curl --request GET \
  --url https://api.decodahealth.com/user/patient/{patient_id} \
  --header 'API-KEY: <api-key>' \
  --header 'TENANT: <tenant>'
{
  "id": "<string>",
  "type": "PROVIDER",
  "createdDate": "2023-11-07T05:31:56Z",
  "firstName": "<string>",
  "lastName": "<string>",
  "phoneNumber": "<string>",
  "email": "<string>",
  "locationId": "<string>",
  "externalId": "<string>",
  "address": "<string>",
  "addressLineTwo": "<string>",
  "city": "<string>",
  "state": "<string>",
  "zipCode": "<string>",
  "country": "<string>",
  "addressValid": true,
  "meta": {},
  "isArchived": true,
  "primaryLocationId": "<string>",
  "gender": "<string>",
  "dateOfBirth": "2023-12-25",
  "patientMedications": [
    "<string>"
  ],
  "onSchedulingBlacklist": true,
  "surchargeDisabled": true,
  "tags": [
    {
      "id": "<string>",
      "name": "<string>",
      "isActive": true,
      "createdDate": "2023-11-07T05:31:56Z",
      "emoji": "<string>",
      "color": "<string>",
      "updatedDate": "2023-11-07T05:31:56Z"
    }
  ],
  "creditBalance": 123,
  "preferredProviderId": "<string>",
  "memberships": [
    {
      "id": "<string>",
      "membership": {
        "id": "<string>",
        "name": "<string>",
        "textColor": "<string>"
      },
      "startDate": "2023-11-07T05:31:56Z",
      "status": "ACTIVE"
    }
  ],
  "goalWeight": 123,
  "measurements": [
    {
      "patientId": "<string>",
      "createdDate": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "height": 123,
      "weight": 123,
      "systolicBp": 123,
      "diastolicBp": 123,
      "pulse": 123,
      "temperature": 123,
      "waistCircumference": 123,
      "noteId": "<string>",
      "measurementDate": "2023-11-07T05:31:56Z",
      "eventId": "<string>",
      "creatorId": "<string>"
    }
  ],
  "medications": [
    {
      "id": "<string>",
      "createdDate": "2023-11-07T05:31:56Z",
      "patientId": "<string>",
      "name": "<string>",
      "providerId": "<string>",
      "sideEffects": "<string>",
      "administrationLocation": "<string>",
      "amount": 123,
      "unit": "AMPOULES",
      "lotNumber": "<string>",
      "stockId": "<string>",
      "noteId": "<string>",
      "doseDate": "2023-11-07T05:31:56Z",
      "comment": "<string>",
      "frequency": "<string>",
      "quantity": 123,
      "isUsedAsTemplate": true,
      "signedOffProviderId": "<string>",
      "signedOffDate": "2023-11-07T05:31:56Z",
      "provider": {
        "id": "<string>",
        "type": "PROVIDER",
        "firstName": "<string>",
        "lastName": "<string>",
        "phoneNumber": "<string>",
        "email": "<string>",
        "locationId": "<string>"
      }
    }
  ],
  "optedOutOfSms": true,
  "appointmentCount": 123,
  "totalSpent": 123,
  "healthData": {},
  "profilePictureUrl": "<string>"
}

Headers

TENANT
string
required

The tenant you are making this request on behalf of

API-KEY
string
required

Your api key

Path Parameters

patient_id
string
required

Response

Successful Response

Extended patient model for the patient detail/chart endpoint that includes health data.

id
string
required

The unique identifier for the user.

type
enum<string>
required

The type of user.

Available options:
PROVIDER,
PATIENT,
ASSISTANT
createdDate
string<date-time>
required

The date and time when the user was created.

firstName
string | null

The user's first name.

lastName
string | null

The user's last name.

phoneNumber
string | null

The user's phone number.

email
string | null

The user's email address.

locationId
string | null

The location of the user.

externalId
string | null

The user's external identifier if available.

address
string | null

The user's primary address.

addressLineTwo
string | null

Additional address information.

city
string | null

The city of the user's address.

state
string | null

The state of the user's address.

zipCode
string | null

The postal code of the user's address.

country
string | null

The country of the user's address.

addressValid
boolean | null

Whether the user's address is valid.

meta
Meta · object

Any additional metadata about the user relevant to your system.

isArchived
boolean | null

Whether the user is archived.

primaryLocationId
string | null

The primary location of the user.

gender
string | null

The gender of the patient.

dateOfBirth
string<date> | null

The date of birth of the patient.

patientMedications
string[] | null

List of patient's self-reported medications.

onSchedulingBlacklist
boolean | null

Whether the patient is on the scheduling blacklist.

surchargeDisabled
boolean | null

Whether surcharges are disabled for this patient.

tags
PatientTagSummary · object[] | null

List of patient tags

creditBalance
integer | null

Patient's credit balance in cents.

preferredProviderId
string | null

The preferred provider ID for this patient.

memberships
MemberTiny · object[] | null

List of memberships for this patient

goalWeight
number | null

The goal weight of the patient.

measurements
MeasurementSummary · object[] | null

List of patient's measurements.

medications
DeprecatedMedicationSummary · object[] | null

List of provider-administered medication doses.

optedOutOfSms
boolean | null

Whether patient has opted out of SMS

appointmentCount
integer | null

Total number of appointments for this patient

totalSpent
integer | null

Total amount spent by this patient in cents

healthData
Healthdata · object

Dynamic health fields and values

profilePictureUrl
string | null

URL to the patient's profile picture.