---
title: "Suggest the schedule stage and next-due date for a dose being administered — which dose of the series this is, and when the next one is due (generalizes the rabies 1-vs-3-year rule)."
method: GET
path: "/api/Vaccinations/next-dose"
tags: ["Vaccinations"]
---

# Suggest the schedule stage and next-due date for a dose being administered — which dose of the series this is, and when the next one is due (generalizes the rabies 1-vs-3-year rule).

`GET /api/Vaccinations/next-dose`

## Request

- Base URL: `https://api.clinicos.vet/backend/business`
- URL: `https://api.clinicos.vet/backend/business/api/Vaccinations/next-dose`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/docs/api/Vaccinations/next-dose/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `patientId` string
- `vaccineTypeId` string
- `administeredDate` string, date-time

## Response `200`

OK

- NextDoseSuggestionDto: Point-of-care suggestion for the dose being administered: which schedule stage it is, and when the NEXT dose is due. Exactly one of int? NextDoseSuggestionDto.SuggestedIntervalDays (series dose coming up, e.g. "lepto dose 2 in 21 days"), int? NextDoseSuggestionDto.SuggestedDurationMonths or int? NextDoseSuggestionDto.SuggestedDurationDays (expiry-driven booster) is set — or neither, when bool NextDoseSuggestionDto.IsSeriesComplete says this dose ends the course. Generalizes the rabies 1-vs-3-year rule (ITE-162) to any vaccine schedule.
  - `vaccineTypeId` string
  - `hasSchedule` boolean: False when the type has no explicit schedule and isn't rabies — plain single-duration behavior.
  - `stageSequence` union: 1-based stage this dose resolves to (1 = first dose or series restart).
    - integer
    - string, int32
  - `stageCount` union
    - integer
    - string, int32
  - `stageLabel` string, nullable
  - `isSeriesRestart` boolean: True when prior doses exist but lapsed beyond the grace window, so the series restarts.
  - `isSeriesComplete` boolean: True when this dose is the last of a non-repeating schedule: nothing further is due, so there is no suggested interval, duration, or next-due date (and no reminders).
  - `isRabies` boolean
  - `suggestedIntervalDays` union: Next dose due this many days after administration (series), else null.
    - integer
    - string, int32
  - `suggestedIntervalMaxDays` union: Upper bound of the recommended window (display only).
    - integer
    - string, int32
  - `suggestedDurationMonths` union: Validity this dose confers in months (expiry-driven), else null.
    - integer
    - string, int32
  - `suggestedDurationDays` union: Validity this dose confers in days (a stage whose duration is set in days/weeks), else null.
    - integer
    - string, int32
  - `labeledDurationMonths` union: The product's labeled (maximum) duration in months. 0 when the type has no duration, no schedule and isn't rabies: doses are open-ended, so there is nothing to suggest.
    - integer
    - string, int32
  - `durationOptionsMonths` union[]: Distinct certifiable durations for the override UI (e.g. [12, 36] for rabies).
    - union
      - integer
      - string, int32
  - `suggestedNextDueDate` string, date-time, nullable: Server-computed next-due date from the given administration date (the FE default). Null when bool NextDoseSuggestionDto.IsSeriesComplete — nothing further is due.

## Other responses

- `404`: Not Found

## Changes

- **2026-10-21** `85ee96c0bb96`: 3 info
  - added the optional property `suggestedDurationDays` to the response with the `200` status (media type: text/plain)
  - added the optional property `suggestedDurationDays` to the response with the `200` status (media type: application/json)
  - added the optional property `suggestedDurationDays` to the response with the `200` status (media type: text/json)
- **2026-08-07** `a905bde4e796`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/changes/api/Vaccinations/next-dose/get.md)

---

[API](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1.md) - [All operations](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/revisions/099cf36186e0?raw)