# FieldAgentListEncountersResponse

Model ID: `fieldagent.ListEncountersResponse`

Response for GET /encounters. Scoped to the caller's tenant, not to the
calling agent — pass ``created_by`` to further restrict results to
encounters that agent created.

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. |
| `encounters` | array of [`fieldagent.Encounter`](./fieldagent.Encounter.md) | Yes |  |  |  | No | Encounters matching the supplied filters, in domain-model format. |
| `patient_id` | `string|null` | Yes |  |  |  | Yes | Echoed back only when the request supplied ?patient_id=; the FHIR Patient ID results were scoped to. |
| `total` | `integer` | Yes |  |  |  | No | Number of encounters in this response (post-filter, post-pagination page size). |

## Example

None declared in canonical OpenAPI.