ApiKeys7

AppointmentConfirmation2

Appointments25

AppointmentTypes10

AutomatedEmailTemplates4

BillableItems5

Breeds5

BulkClientExport2

BulkPatientExport2

CareQueue2

CaseMilestones6

Cases5

ChatExport1

ClientAccount1

ClientCredit2

ClientExport3

Clients6

ClientStatement1

ClinicalAddenda2

ClinicConfig41

ClinicSettings2

Clocking6

Compliance1

ConsentDocuments2

DeaBooks10

DeaExport2

DentalCharts9

DeviceFormHandoffs4

DevicePush3

Devices5

DeviceSelf1

DiagnosisTerms1

DischargeSignOff2

Disclaimers7

DiscountCodes7

Drafts7

EdgePrinters3

EdgePrintJobs2

EmailVerification2

EmergencyIntake2

Erx6

Estimates30

ExamTemplates6

Expenses6

Featurebase2

FeatureFlags1

Flowboard10

FormHandoffs6

GroupCodes7

GroupVisits6

Health1

HomeAgain4

HospitalStays18

IntegrationCredentials18

InternalPrescribing1

InternalWidget1

Inventory25

InventoryApprovals5

InventoryLocations7

Invoices29

JourneyMilestones6

Kiosk4

LabPanels5

Labs21

LineItemNotes5

LocationClosures4

Locations11

Logos7

MedicationRequests7

MentorMetrics5

MessageAttachments4

Metrics31

NpsAnalytics3

NvsIntegration11

OnlineBookingReadiness1

Partners6

PatientGroups9

PatientMasses6

PatientProblems4

PatientRecordExport3

Patients21

Payments22

PaymentTokens5

Pep5

Pharmacies5

Phones2

PriceRules6

Printers7

PrintJobs4

PtoRequests6

PublicDevicePairing1

PublicEmailUnsubscribe2

PublicFileLinks2

PublicFormHandoffs1

PublicNps2

PublicPriceList5

PublicQuestionnaires4

PublicSmsConsent2

PurchaseOrders11

QiEvents9

QuestionnaireResponses7

Questionnaires18

RabiesTags10

RdvmPortal22

Recordings9

RecurringExpenses5

ReferralMessages2

Referrals20

Reminders14

Reports2

RetailItems11

Roles6

RoomDayAssignments3

RxGovernance26

SavedReports5

ScheduleItems10

ServiceCatalog5

Shifts5

ShiftSwaps8

SlotConfigurations6

SmsConsent9

Species5

StaffAvailability1

Subscriptions10

SurgicalRecords11

TagAssignments4

Tags5

TelnyxCallControl1

Templates16

TenantKnowledge5

TimeEntries5

Transparency3

Users14

Vaccinations12

VaccineAdministration3

VaccineCertificateRecords6

VaccineCertificates2

VaccineTypes5

Vendors6

Vitals2

VitalTypes6

Widget18

WidgetChatbot4

WorkItemRules5

WorkTasks13

MedicationRequests

Approve (provider with Dispense permission + the primary-provider flag). For Rx this authors the Prescription, routes it, and creates the request's own quote estimate with its Pending line (one estimate per request).

Changed on Oct 28, 2026

post/medication-requests/{id}/approve

Request

Base URL
https://api.clinicos.vet/backend/business
Auth
HTTP bearer
TypeScript
https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/docs/medication-requests/:id/approve/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idstring required

Request body

useRefillboolean nullable

Renewal approval mode (design §7). True = "use a refill": increments RefillsUsed on the prior Rx and reuses it — no new legal record, no SIG. False/absent on a renewal = "new prescription" (the normal create path, keeping the renewal link). 409 when the prior Rx is inactive, expired, exhausted, or DEA Schedule II.

providerIdstring nullable

Prescribing DVM. Defaults to the approving caller.

inventoryItemIdstring nullable

Resolves a free-text capture to a real item (required if capture had none).

fulfillmentMethodstring nullable

pharmacyIdstring nullable

dosagestring nullable

frequencystring nullable

durationstring nullable

instructionsstring nullable

SIG — required for Rx approval.

refillsPrnboolean nullable

PRN ("as needed") refills: unlimited fills until the Rx expires (ITE-1596).

validUntilstring date nullable

Rx expiration override. Null = the regional default validity window.

medicationExpirationDatestring date nullable

Medication expiration printed on the label when no dispensed lot supplies one.

medicationCategorystring nullable

notesstring nullable

estimateIdstring nullable

Escape hatch from one-estimate-per-request: put the billable line on this existing live estimate instead of a fresh standalone draft (e.g. adding a med to an estimate about to be presented, or the visit's estimate).

createNewEstimateboolean

True = put the line on a fresh estimate for this request even though the capturer chose one (string? MedicationRequestDto.TargetEstimateId). Without it, an approval with no string? ApproveMedicationRequestDto.EstimateId uses the capturer's choice (ITE-1713).

isCascadeboolean nullable

cascadeReasonstring nullable

antimicrobialUseTypestring nullable

antimicrobialJustificationstring nullable

clinicalAssessmentPerformedboolean nullable

physicalExamPerformedboolean nullable

physicalExamJustificationstring nullable

withdrawalPeriodstring nullable

Response

idstring

patientIdstring

patientNamestring nullable

clientIdstring nullable

inventoryItemIdstring nullable

medicationNamestring nullable

freeTextMedicationstring nullable

notesstring nullable

sourcestring

isOtcboolean

isControlledboolean

Whether the linked inventory item carries any DEA/controlled-substance signal. Mirrors the approval gate's own controlled test (RxGovernanceService.IsControlledItem): a controlled item always needs a primary provider to approve or deny, whatever RxGovernanceSettings says. False for an unresolved free-text request — there is no item to judge yet, so read it together with InventoryItemId.

fulfillmentMethodstring nullable

statusstring

billingStatestring

requestedByIdstring nullable

requestedByNamestring nullable

requestedAtstring date-time

approvedByIdstring nullable

approvedByNamestring nullable

approvedAtstring date-time nullable

deniedByIdstring nullable

deniedAtstring date-time nullable

denialReasonstring nullable

cancelledByIdstring nullable

cancelledAtstring date-time nullable

cancelReasonstring nullable

dispensedAtstring date-time nullable

prescriptionIdstring nullable

prescriptionItemIdstring nullable

estimateIdstring nullable

estimateLineItemIdstring nullable

targetEstimateIdstring nullable

The estimate chosen at capture for the line approval will create (ITE-1713). string? MedicationRequestDto.EstimateId is where the line actually is, once it exists.

targetEstimateNumberstring nullable

targetEstimateIsVisitboolean

True when string? MedicationRequestDto.TargetEstimateId is a visit's (appointment's) estimate.

targetEstimateIsOpenboolean

False when string? MedicationRequestDto.TargetEstimateId has been invoiced or declined since capture: approval will put the line on a fresh estimate instead, so it is not a usable choice.

invoiceIdstring nullable

renewalOfPrescriptionIdstring nullable

suggestedProviderIdstring nullable

suggestedDosagestring nullable

suggestedFrequencystring nullable

suggestedDurationstring nullable

suggestedInstructionsstring nullable

createdAtstring date-time

updatedAtstring date-time

Changes

Oct 28, 2026099cf36186e0 Revision changes
- info
  added the new optional request property (media type: application/json)
- info
  added the new optional request property (media type: text/json)
- info
  added the new optional request property (media type: application/*+json)
- info
  added the new optional request property (media type: application/json)
- info
  added the new optional request property (media type: text/json)
- info
  added the new optional request property (media type: application/*+json)
- info
  added the new optional request property (media type: application/json)
- info
  added the new optional request property (media type: text/json)
- info
  added the new optional request property (media type: application/*+json)
- info
  added the new optional request property (media type: application/json)
- info
  added the new optional request property (media type: text/json)
- info
  added the new optional request property (media type: application/*+json)
- info
  added the optional property ///// to the response with the status (media type: text/plain)
- info
  added the optional property ///// to the response with the status (media type: application/json)
- info
  added the optional property ///// to the response with the status (media type: text/json)
- info
  added the optional property to the response with the status (media type: text/plain)
- info
  added the optional property to the response with the status (media type: application/json)
- info
  added the optional property to the response with the status (media type: text/json)
- info
  added the optional property to the response with the status (media type: text/plain)
- info
  added the optional property to the response with the status (media type: application/json)
- info
  added the optional property to the response with the status (media type: text/json)
- info
  added the optional property to the response with the status (media type: text/plain)
- info
  added the optional property to the response with the status (media type: application/json)
- info
  added the optional property to the response with the status (media type: text/json)
- info
  added the optional property to the response with the status (media type: text/plain)
- info
  added the optional property to the response with the status (media type: application/json)
- info
  added the optional property to the response with the status (media type: text/json)
Sep 17, 2026d4ae30be0619 Revision changes
- info
  added the optional property to the response with the status (media type: text/plain)
- info
  added the optional property to the response with the status (media type: application/json)
- info
  added the optional property to the response with the status (media type: text/json)

Operation history