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

# {{baseUrl}}/persons

`GET /persons`

Gets a list of persons/patients. If OData $filter criteria for createTimestamp and/or /modifyTimestamp are not specified, the default behavior of this route is to return results for persons/patients that have been created or modified in the last 7 days.

## Query parameters

- `patientsOnly` string, required
- `$top` string, required
- `$filter` string, required
- `$orderby` string, required
- `$skip` string, required
- `$inlinecount` string, required
- `$count` string, required

## Headers

- `Accept` string, required

## Response `200`

OK

- OK78
  - `Count` string, required
  - `Items` Item34[], required
    - `_links` Link[], required
      - `href` string, required
      - `method` string, required
      - `rel` string, required
      - `description` string, required
      - `vendorExtensions` string, required
    - `checkInDateTime` string, required
    - `checkInTimezone` string, required
    - `checkOutDateTime` string, required
    - `checkOutTimezone` string, required
    - `encounterNumber` string, required
    - `enterpriseId` string, required
    - `id` string, required
    - `isLocked` string, required
    - `isSensitive` string, required
    - `locationId` string, required
    - `locationName` string, required
    - `personId` string, required
    - `practiceId` string, required
    - `printOnStatements` string, required
    - `referringProviderId` string, required
    - `referringProviderName` string, required
    - `renderingProviderId` string, required
    - `renderingProviderName` string, required
    - `status` string, required
    - `suppressOutreach` string, required
    - `suppressPortal` string, required
    - `timestamp` string, required
    - `timestampTimezone` string, required
  - `NextPageLink` string, required

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found

---

[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)