Skip to main content
GET
/
api
/
v1
/
patients
Get patients
curl --request GET \
  --url https://api.byblend.com/api/v1/patients \
  --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.

Query Parameters

​
page
integer

Page number for pagination

Example:

1

​
page_size
integer

Number of items per page; defaults to 25, max of 200

Example:

25

Response

200 - application/json

Successful response with an array of patients.

​
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