---
title: "{{baseUrl}}/persons/lookup"
method: GET
path: "/persons/lookup"
tags: ["Patient Demographics"]
---

# {{baseUrl}}/persons/lookup

`GET /persons/lookup`

Gets a list of persons/patients based on various search criteria.  Since these results are returned from a /persons/ endpoint, the "id" of each result (whose value is a guid) is a personId and can be used as the value of personId in all other routes that require a personId.

Using the /persons/lookup route:

-At least one query parameter must be provided as lookup criteria.
-Use of multiple criteria is allowed, and will results will include person records matching all criteria.
-The two "quickSearch" parameters are exceptions to the above; see the quickSearchId & quickSearchInput parameter descriptions for details.

## Query parameters

- `name` string, required
- `firstName` string, required
- `lastName` string, required
- `middleName` string, required
- `priorLastName` string, required
- `addressLine1` string, required
- `city` string, required
- `zip` string, required
- `sex` string, required
- `currentGender` string, required
- `dateOfBirth` string, required
- `externalId` string, required
- `externalSystemId` string, required
- `excludeExpired` string, required
- `isNextMdEnabled` string, required
- `searchPatientsOnly` string, required
- `quickSearchId` string, required
- `quickSearchInput` string, required
- `$expand` string, required

## Headers

- `Accept` string, required

## Response `200`

OK

- OK84
  - `id` string, required
  - `firstName` string, required
  - `lastName` string, required
  - `middleName` string, required
  - `nickname` string, required
  - `addressLine1` string, required
  - `addressLine2` string, required
  - `city` string, required
  - `state` string, required
  - `zip` string, required
  - `country` string, required
  - `homePhone` string, required
  - `dateOfBirth` string, required
  - `sex` string, required
  - `currentGender` string, required
  - `socialSecurityNumber` string, required
  - `personNumber` string, required
  - `medicalRecordNumber` string, required
  - `otherIdNumber` string, required
  - `isEnterpriseChart` string, required
  - `isPatient` string, required
  - `canAddToInclusionList` string, required
  - `_links` Link[], required
    - `href` string, required
    - `method` string, required
    - `rel` string, required
    - `description` string, required
    - `vendorExtensions` string, required

## Other responses

- `400` — Bad Request
- `403` — Forbidden

---

[API](https://skmtc.net/nextgen/apis/enterprise-api-uscdi-routes.md) · [All operations](https://skmtc.net/nextgen/apis/enterprise-api-uscdi-routes/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nextgen/enterprise-api-uscdi-routes/revisions/191e69116448/schema)