---
title: "POST /pep/referrals/preview"
method: POST
path: "/pep/referrals/preview"
tags: ["Pep"]
---

# POST /pep/referrals/preview

`POST /pep/referrals/preview`

## Request

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

## Request body

- PepReferralRequest
  - `patientId` string, required
  - `appointmentId` string, nullable
  - `requestId` string, uuid
  - `previewHash` string, nullable
  - `consentConfirmed` boolean
  - `allowPossibleDuplicate` boolean
  - `includeDiagnosis` boolean
  - `phoneOverride` string, nullable
  - `clinicalNotes` string, nullable
  - `urgency` string, nullable
  - `preferredDate` string, date, nullable
  - `preferredTime` string, nullable

## Response `200`

OK

- PepPreviewDto
  - `patientName` string, required
  - `clientName` string, required
  - `phone` string, required
  - `payload` PepReferralPayload, required
    - `practice` PepPractice
      - `practice_name` string, nullable
      - `referring_user` string, nullable
    - `client` PepClient, required
      - `client_first_name` string, nullable
      - `client_last_name` string, nullable
      - `client_phone` string, required
      - `client_email` string, nullable
      - `client_postcode` string, nullable
      - `client_address_line_1` string, nullable
      - `client_address_line_2` string, nullable
      - `client_city` string, nullable
    - `patient` PepPatient, required
      - `pet_name` string, required
      - `pet_species` string, nullable
      - `pet_breed` string, nullable
      - `pet_age_years` union
        - number, double
        - string, double
      - `pet_weight_kg` union
        - number, double
        - string, double
      - `pet_sex` string, nullable
      - `pet_microchip` string, nullable
    - `notes` PepNotes
      - `clinical_notes` string, nullable
      - `clinical_diagnosis` string, nullable
      - `urgency` string, nullable
      - `preferred_date` string, date, nullable
      - `preferred_time` string, nullable
  - `validationError` string, nullable, required
  - `suggestionReason` string, nullable, required
  - `payloadHash` string, nullable, required

## Changes

- **2026-10-28** `099cf36186e0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/changes/pep/referrals/preview/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)