Skip to main content
GET
/
api
/
v1
/
patients
/
{patient_id}
Get a patient's details
curl --request GET \
  --url https://api.byblend.com/api/v1/patients/{patient_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "0227d1e5-ba9a-42b5-8fe2-38882aa65708",
  "created_at": "2025-03-15T12:00:00Z",
  "updated_at": "2025-03-15T12:00:00Z",
  "first_name": "Willard",
  "middle_name": "Moises",
  "last_name": "Donnelly",
  "gender": "male",
  "email": "[email protected]",
  "phone": "6417383445",
  "date_of_birth": "1990-01-01",
  "driver_license_number": "B49188319",
  "driver_license_state": "CA",
  "ssn": "123456789",
  "primary_language": "en",
  "guardian_name": "John Guardian",
  "guardian_phone": "6417383445",
  "guardian_email": "[email protected]",
  "guardian_relationship": "parent",
  "height_inches": 72,
  "weight_pounds": 180,
  "external_id": "1234567890",
  "is_smoker": false,
  "is_diabetic": false,
  "is_pregnant": false,
  "receive_sms": true,
  "receive_email": true,
  "address": {
    "address_1": "140 Lindgren Streets",
    "city": "North Consueloburgh",
    "state": "CA",
    "zip_code": "02108",
    "address_2": "Apt 227",
    "country": "US"
  },
  "is_minor": false
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
patient_id
string<uuid>
required

Unique identifier for the patient, either UUID or external ID (e.g. my-patients-128318AA2) if you have provided one during patient creation or update.

Example:

"98cae3a3-996c-4bf5-9143-0ab6d98bc1d0"

Response

200 - application/json

Successful response with patient details

​
id
string<uuid>

Unique identifier

Example:

"0227d1e5-ba9a-42b5-8fe2-38882aa65708"

​
created_at
string<date-time>

Date and time of creation

Example:

"2025-03-15T12:00:00Z"

​
updated_at
string<date-time>

Date and time of last update

Example:

"2025-03-15T12:00:00Z"

​
first_name
string
Example:

"Willard"

​
middle_name
string
Example:

"Moises"

​
last_name
string
Example:

"Donnelly"

​
gender
enum<string>

Gender of the patient

Available options:
male,
female
Example:

"male"

​
email
string
​
phone
string

10-digit phone number without formatting, e.g. 6417383445

Example:

"6417383445"

​
date_of_birth
string<date>
Example:

"1990-01-01"

​
driver_license_number
string
Example:

"B49188319"

​
driver_license_state
string
Example:

"CA"

​
ssn
string

Social Security number. Can be provided with or without hyphens.

Example:

"123456789"

​
primary_language
string

ISO 639-1 language code

Example:

"en"

​
guardian_name
string

Name of the patient's guardian. Required if patient is a minor.

Example:

"John Guardian"

​
guardian_phone
string
Example:

"6417383445"

​
guardian_email
string
​
guardian_relationship
string

Relationship of the guardian to the patient. See relationship types lookup for available values; most common are parent and legal_guardian; and other can be used.

Example:

"parent"

​
height_inches
integer

Height of the patient in inches

Example:

72

​
weight_pounds
integer

Weight of the patient in pounds

Example:

180

​
external_id
string

External (your own) ID for the patient, to be used for prescription matching

Example:

"1234567890"

​
is_smoker
boolean

Whether the patient is a smoker

Example:

false

​
is_diabetic
boolean

Whether the patient is diabetic

Example:

false

​
is_pregnant
boolean

Whether the patient is pregnant

Example:

false

​
receive_sms
boolean

Whether the patient should receive SMS notifications for shipments. This is only applicable if you have authorized Blend to send patient communications on your behalf.

Example:

true

​
receive_email
boolean

Whether the patient should receive email notifications for shipments. This is only applicable if you have authorized Blend to send patient communications on your behalf.

Example:

true

​
address
object
​
is_minor
boolean

Whether the patient is a minor. Automatically calculated based on date of birth.

Example:

false