GET
/
medical
/
v1
/
patient

This is a paginated endpoint. For more information see pagination.

​
Query Params

​
facilityId
string

The ID of the Facility where the patient is receiving care, optional. If not provided, Patients from all Facilities will be returned.

​
filters
string

How to filter patients. It uses Metriport’s filter/search criteria based on the main properties of a Patient: first name, last name, date of birth, ID, and external ID.

One can combine fields as needed, for example:

  • john or doe will return all patients with the first and/or last name equal to john or doe.
  • john -doe will return all patients with the first and/or last name equal to john but without any doe either on first or last names.
  • john 2000 will return all patients with the first and/or last name equal to john and born in the year 2000.
  • 2000-02-03 will return all patients born on 2020-02-03.
  • ABCD1234 will return all patients with that external ID.

Date of birth should follow the format ISO 8601 (YYYY-MM-DD), but partial values are accepted (YYYY, YYYY-MM)

​
Response

All Patients receiving care at the specified Facility, or all Patients if no Facility is specified.

​
patients
Patient[]
{
  "meta": {
    "itemsOnPage": 2
  },
  "patients": [
    {
      "id": "018a80c4-292a-7486-a1234-76yuhe23yu14",
      "facilityIds": ["018a80c4-292a-7486-a1234-9uiu76yhe234"],
      "firstName": "Jose",
      "lastName": "Juarez",
      "dob": "1951-05-05",
      "genderAtBirth": "M",
      "personalIdentifiers": [
        {
          "type": "driversLicense",
          "state": "CA",
          "value": "51227265"
        }
      ],
      "address": [
        {
          "zip": "12345",
          "city": "San Diego",
          "state": "CA",
          "country": "USA",
          "addressLine1": "Guadalajara St"
        }
      ],
      "contact": [
        {
          "phone": "1234567899",
          "email": "jose@domain.com"
        }
      ],
      "externalId": "123456789"
    },
    {
      "id": "018a80c4-292a-7486-a1234-5ert32uij123",
      "externalId": "123456789",
      "facilityIds": ["018a80c4-292a-7486-a1234-9uiu76yhe234"],
      "firstName": "Josita",
      "lastName": "Juarez,Diaz",
      "dob": "1949-06-09",
      "genderAtBirth": "F",
      "address": [
        {
          "zip": "12345",
          "city": "San Diego",
          "state": "CA",
          "country": "USA",
          "addressLine1": "Guadalajara St"
        }
      ]
    }
  ]
}
Match PatientDelete Patient