---
title: "Fetch patient information"
method: GET
path: "/patient"
tags: ["Patient"]
---

# Fetch patient information

`GET /patient`

## Request

- Base URL: `/api/v4` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v4/patient`
- Auth: HTTP bearer and API key in header `X-PATIENT-ID`

## Headers

- `HTTP_X_PATIENT_ID` unknown

## Response `200`

Patient information is returned

- object
  - `patient` Patient
    - `id` string, uuid
    - `full_name` string: This string should not be empty.
    - `age` integer, nullable
    - `gender` 'male' | 'female' | 'transgender'
    - `status` 'active' | 'dead' | 'migrated' | 'unresponsive' | 'inactive'
    - `recorded_at` string, date-time: Timestamp with millisecond precision.
    - `reminder_consent` 'granted' | 'denied'
    - `phone_numbers` object[], nullable
      - `id` string, uuid
      - `number` string: This string should not be empty.
    - `address` object
      - `id` string, uuid
      - `street_address` string, nullable
      - `village_or_colony` string, nullable
      - `district` string, nullable
      - `zone` string, nullable
      - `state` string, nullable
      - `country` string, nullable
      - `pin` string, nullable
    - `registration_facility` object
      - `id` string, uuid
      - `name` string: This string should not be empty.
      - `street_address` string, nullable
      - `village_or_colony` string, nullable
      - `district` string, nullable
      - `state` string, nullable
      - `country` string, nullable
      - `pin` string, nullable
    - `medical_history` object
      - `cholesterol_value` number
      - `smoking` 'yes' | 'no' | 'unknown'
      - `chronic_kidney_disease` 'yes' | 'no' | 'unknown'
      - `diabetes` 'yes' | 'no' | 'unknown'
      - `hypertension` 'yes' | 'no' | 'unknown'
      - `prior_heart_attack` 'yes' | 'no' | 'unknown'
      - `prior_stroke` 'yes' | 'no' | 'unknown'
    - `blood_pressures` object[], nullable
      - `systolic` integer
      - `diastolic` integer
      - `recorded_at` string, date-time: Timestamp with millisecond precision.
      - `facility` object
        - `id` string, uuid
        - `name` string: This string should not be empty.
        - `street_address` string, nullable
        - `village_or_colony` string, nullable
        - `district` string, nullable
        - `state` string, nullable
        - `country` string, nullable
        - `pin` string, nullable
    - `blood_sugars` object[], nullable
      - `blood_sugar_value` number
      - `blood_sugar_type` 'random' | 'post_prandial' | 'fasting' | 'hba1c'
      - `recorded_at` string, date-time: Timestamp with millisecond precision.
      - `facility` object
        - `id` string, uuid
        - `name` string: This string should not be empty.
        - `street_address` string, nullable
        - `village_or_colony` string, nullable
        - `district` string, nullable
        - `state` string, nullable
        - `country` string, nullable
        - `pin` string, nullable
    - `appointments` object[], nullable
      - `scheduled_date` string, date
      - `status` 'scheduled' | 'cancelled' | 'visited'
      - `facility` object
        - `id` string, uuid
        - `name` string: This string should not be empty.
        - `street_address` string, nullable
        - `village_or_colony` string, nullable
        - `district` string, nullable
        - `state` string, nullable
        - `country` string, nullable
        - `pin` string, nullable
    - `medications` object[], nullable
      - `name` string: This string should not be empty.
      - `dosage` string
      - `rxnorm_code` string
      - `is_protocol_drug` boolean

## Other responses

- `401`: Invalid patient ID header

## Changes

- **2020-05-06** (v4) `63c76139e189`: 2 info
  - the endpoint scheme security `access_token AND patient_id` was added to the API
  - the endpoint scheme security `basic` was removed from the API
- **2020-04-20** (v4) `44261500935e`: 2 info
  - the endpoint scheme security `basic` was added to the API
  - the endpoint scheme security `access_token AND patient_id` was removed from the API

[Operation history](https://skmtc.dev/simpledotorg/apis/simple-api/changes/patient/get.md)

---

[API](https://skmtc.dev/simpledotorg/apis/simple-api.md) - [All operations](https://skmtc.dev/simpledotorg/apis/simple-api/llms.txt) - [OpenAPI document](https://skmtc.dev/simpledotorg/apis/simple-api/revisions/31ffa1d07978?raw)