---
title: "Latest requisition order status"
method: GET
path: "/api/v1/requisitions/latest"
tags: ["requisitions"]
---

# Latest requisition order status

`GET /api/v1/requisitions/latest`

## Request

- Base URL: `https://api.endless.health` (the document declares no server; this is the origin it was published from)
- URL: `https://api.endless.health/api/v1/requisitions/latest`
- Auth: none declared

Return the current order status for the authenticated patient.

Reads from RS plus local supporting tables (order_lookup,
registration_information, external_kit_order). When a kit was just
registered and RS has not created its requisition yet, data.pending_registration
carries that kit. Existing fields stay the RS latest kit.

## Response `200`

Successful Response

- LatestRequisitionStatusResponseSchema: Envelope for GET /api/v1/requisitions/latest.
  - `status` string, required
  - `message` string, required
  - `data` LatestRequisitionDataSchema: Portal latest order status.
    - `requisition` RequisitionSchema: Requisition status payload (portal; shared by requisitions and legacy user-orders).
      - `status` 'ORDER_CREATED' | 'MD_APPROVED' | 'MD_REJECT' | 'LAB_ACCEPT' | 'LAB_REJECT' | 'TEST_COMPLETE' | 'ORDER_COMPLETE' | 'ORDER_CANCELLED', required
      - `id` integer, required
      - `organization` string, required
      - `external_id` string, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `reason` string, nullable, required
      - `requisition_notes` RequisitionNoteResponseSchema[], nullable, required
        - `id` integer, required
        - `requisition_id` integer, required
        - `note` string, nullable
        - `contacted` boolean, nullable
        - `created_at` string, date-time, required
    - `requisition_note` RequisitionNoteResponseSchema: Requisition note (portal; shared by requisitions and legacy user-orders).
      - `id` integer, required
      - `requisition_id` integer, required
      - `note` string, nullable
      - `contacted` boolean, nullable
      - `created_at` string, date-time, required
    - `activation_code` string, required
    - `has_external_kit` boolean, required
    - `is_replace_requested` boolean, required
    - `replace_requested_at` string, date-time, nullable
    - `has_replacement` boolean, required
    - `pending_registration` PendingRegistrationSchema: A kit registered in core before Requisition Service has created it. Present only while registration_information.requisition_id is still NULL and the row is newer than the RS latest kit, within a short timeout.
      - `activation_code` string, required
      - `registered_at` string, date-time, required

## Other responses

- `404`: Not found

---

[API](https://skmtc.dev/endless/apis/eh-core-v3-api-prod.md) - [All operations](https://skmtc.dev/endless/apis/eh-core-v3-api-prod/llms.txt) - [OpenAPI document](https://skmtc.dev/endless/apis/eh-core-v3-api-prod/revisions/9046a1eb2d0c?raw)