---
title: "Send client follow-up notification"
method: POST
path: "/rx/governance/{id}/nudge"
tags: ["RxGovernance"]
---

# Send client follow-up notification

`POST /rx/governance/{id}/nudge`

## Request

- Base URL: `https://api.clinicos.vet/backend/business`
- URL: `https://api.clinicos.vet/backend/business/rx/governance/{id}/nudge`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/docs/rx/governance/:id/nudge/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required

## Request body

- NudgeClientDto
  - `channel` string
  - `template` string, nullable
  - `customMessage` string, nullable

## Response `200`

OK

- RxGovernanceDto
  - `id` string
  - `createdDate` string
  - `patientName` string
  - `species` string
  - `clientName` string
  - `medication` string
  - `medicationId` string, nullable
  - `medicationCategory` string, nullable
  - `deaSchedule` string, nullable
  - `strength` string, nullable
  - `provider` string
  - `status` string
  - `guardrails` GuardrailChecksDto
    - `dose` boolean
    - `interaction` boolean
    - `allergy` boolean
  - `events` RxEventDto[]
    - `type` string
    - `timestamp` string, date-time
    - `actor` string
    - `data` object, nullable
  - `routing` RxRoutingDto
    - `id` string
    - `method` string
    - `pharmacyId` string, nullable
    - `pharmacyName` string, nullable
    - `externalRxNumber` string, nullable
    - `inventoryLotId` string, nullable
    - `trackingNumber` string, nullable
    - `estimatedDeliveryTime` string, nullable
    - `notes` string, nullable
    - `routedAt` string, date-time
    - `routedBy` string, nullable
  - `lastExamDate` string, nullable: Patient's last exam date (VCPR - Veterinary-Client-Patient Relationship)
  - `patientId` string, nullable
  - `prescriptionItemId` string, nullable
  - `quantity` union
    - number, double
    - string, double
  - `transactionId` string, nullable
  - `invoiceLineItemId` string, nullable: Set when the dispense-from-inventory call included an InvoiceId and a line item was created atomically with the dispense. Lets clients append the line item locally without refetching.
  - `invoiceId` string, nullable: The estimate the dispense was attached to — either the one the caller supplied or one auto-created/resolved server-side. Lets a client that had no estimate of its own adopt the server's estimate instead of failing to reconcile the line.
  - `estimateId` string, nullable: The draft Estimate the dispense-from-inventory landed on (the single billing path — the request's own quote estimate, fulfilled by the dispense). The payments panel converts this estimate instead of direct-creating a parallel bill (ITE-678). Mutually exclusive with string? RxGovernanceDto.InvoiceLineItemId.
  - `estimateLineItemId` string, nullable: The Performed estimate line the dispense fulfilled, when string? RxGovernanceDto.EstimateId is set.
  - `dosage` string, nullable
  - `frequency` string, nullable
  - `duration` string, nullable
  - `instructions` string, nullable
  - `amendment` RxAmendmentSummaryDto: The latest post-dispense amendment, alongside the directions it superseded. The "as dispensed" fields are read from that amendment's `OriginalContent`, which is a snapshot of the PrescriptionItem — and post-dispense the item never mutates, so every amendment's OriginalContent describes the same dispensed state. The most recent one is therefore enough; earlier amendments need not be replayed.
    - `reason` string
    - `amendedAt` string, date-time
    - `amendedByDisplayName` string, nullable
    - `amendmentCount` union: How many amendments this prescription has accumulated.
      - integer
      - string, int32
    - `dispensedDosage` string, nullable
    - `dispensedFrequency` string, nullable
    - `dispensedDuration` string, nullable
    - `dispensedInstructions` string, nullable
  - `prescriberLicenseNumber` string, nullable
  - `distributionCategorySnapshot` string, nullable
  - `isCascade` boolean
  - `cascadeReason` string, nullable
  - `antimicrobialUseType` string, nullable
  - `antimicrobialJustification` string, nullable
  - `clinicalAssessmentPerformed` boolean
  - `physicalExamPerformed` boolean
  - `physicalExamJustification` string, nullable
  - `validUntil` string, nullable: ISO date string (YYYY-MM-DD).
  - `repeatCount` union
    - integer
    - string, int32
  - `refillsAllowed` union: Refills authorized on the prescription item (US-style refills). Distinct from int RxGovernanceDto.RepeatCount, which is the UK repeat-dispensing value (ITE-475).
    - integer
    - string, int32
  - `refillsUsed` union: Refills already used against int RxGovernanceDto.RefillsAllowed.
    - integer
    - string, int32
  - `refillsPrn` boolean: PRN refills: unlimited until string? RxGovernanceDto.ValidUntil; RefillsAllowed is then 0.
  - `medicationExpirationDate` string, nullable: ISO date string (YYYY-MM-DD). Medication expiration entered on the Rx.
  - `withdrawalPeriod` string, nullable

## Other responses

- `404`: Not Found

## Changes

- **2026-10-28** `099cf36186e0`: 6 info
  - added the optional property `medicationExpirationDate` to the response with the `200` status (media type: text/plain)
  - added the optional property `medicationExpirationDate` to the response with the `200` status (media type: application/json)
  - added the optional property `medicationExpirationDate` to the response with the `200` status (media type: text/json)
  - added the optional property `refillsPrn` to the response with the `200` status (media type: text/plain)
  - …2 more
- **2026-10-21** `85ee96c0bb96`: 6 info
  - added the optional property `refillsAllowed` to the response with the `200` status (media type: text/plain)
  - added the optional property `refillsAllowed` to the response with the `200` status (media type: application/json)
  - added the optional property `refillsAllowed` to the response with the `200` status (media type: text/json)
  - added the optional property `refillsUsed` to the response with the `200` status (media type: text/plain)
  - …2 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/changes/rx/governance/:id/nudge/post.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)