# List Recent Patients (v2)

Lists the patients the acting admin recently picked in the inbox's patient search, newest first, at most 5, with how many of their episodes are open, in progress and closed. A recent patient with no episode matching the filters is still listed, with zero counts. Needs an admin in context.

Endpoint: GET /v2/recent_patients
Version: 1.0.0
Security: apiKeyAuth, practiceGroupId

## Security:

  - `apiKeyAuth` (unknown)
    apiKey in header x-api-key

  - `practiceGroupId` (unknown)
    apiKey in header x-practice-group-id

## Query parameters:

  - `assignee_id[]` (array)

  - `assignee_type[]` (array)

  - `status[]` (array)

  - `priority[]` (array)

## Response 200:

  - `200` (unknown)
    Ok

## Response 200 fields (application/json):

  - `count` (number, required)

  - `data` (array, required)

  - `data.id` (string, required)

  - `data.full_name` (string, required)

  - `data.first_name` (string, required)

  - `data.last_name` (string, required)

  - `data.dob` (string, required)

  - `data.nhs_number` (string, required)

  - `data.sex` (string, required)
    Enum: "Not known", "Not specified", "Male", "Female", "Other"

  - `data.ehr_partner_id` (string, required)

  - `data.data_source` (string, required)
    Enum: "hero", "emis", "pds", "gha", "systm_one"

  - `data.ehr_partner` (string, required)
    Enum: "emis", "systm_one", "other"

  - `data.registration_status` (string, required)
    Enum: "unregistered", "registered", "invited", "archived"

  - `data.ehr_registered` (boolean, required)

  - `data.restricted` (boolean, required)

  - `data.deceased_at` (string, required)

  - `data.last_sync_at` (string, required)

  - `data.episodes` (object, required)

  - `data.episodes.open` (integer, required)

  - `data.episodes.in_progress` (integer, required)

  - `data.episodes.closed` (integer, required)

  - `data.episodes.total` (integer, required)

## Response 400:

  - `400` (unknown)
    Validation error

## Response 400 fields (application/json):

  - `error` (boolean, required)
    Example: true

  - `statusCode` (number, required)
    Example: 400

  - `message` (array, required)

  - `message.code` (string, required)
    Example: invalid_type

  - `message.expected` (string, required)
    Example: string

  - `message.path` (array, required)
    Example: ["patient_id"]

  - `message.message` (string, required)
    Example: Required

## Response 401:

  - `401` (unknown)
    Unauthorised

## Response 422:

  - `422` (unknown)
    No admin in context

## Response 429:

  - `429` (unknown)
    Too Many Requests

## Response 500:

  - `500` (unknown)
    Unknown error