# FieldAgentListPatientsResponse

Model ID: `ListPatientsResponse`

Response for GET /patients. Scoped to the caller's tenant (resolved from
the Bearer JWT), not to the calling agent — pass ``created_by`` to further
restrict results to patients that agent registered.

Type: `object`

## Fields

| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|---|---|---:|---|---|---|---:|---|
| `created_by` | `string` | No |  |  |  | No | Echoed back only when the request supplied ?created_by=; the FHIR Person ID of the field agent the results were filtered to. |
| `next_page_token` | `string|null` | Yes |  |  |  | Yes | Opaque token for the next page; null when a name or created_by filter is applied, or no further results exist. |
| `patients` | array of [`PatientDemographics`](./PatientDemographics.md) | Yes |  |  |  | No | Patients matching the supplied filters, in domain-model format. |
| `total` | `integer` | Yes |  |  |  | No | Number of patients in this response (post-filter, post-pagination page size). |

## Example

None declared in canonical OpenAPI.