How to retrieve SOAP examination records and medical history via the Vetigen API.

Medical Records Guide

Access SOAP examination records (Subjective, Objective, Assessment, Plan) for patients. Requires the medical_records:read scope.

Get a SOAP Record

Retrieve a specific SOAP examination note by its fingerprint.

curl https://api.vetigen.com/api/v1/soap/soap_01JQMKXXXXX \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

Response

{
  "success": true,
  "data": {
    "fp": "soap_01JQMKXXXXX",
    "type": "EXAMINATION",
    "status": "SIGNED",
    "patient": {
      "fp": "patient_01JQMKXXXXX",
      "name": "Luna",
      "species": "cat"
    },
    "subjective": "Owner reports decreased appetite for 3 days. No vomiting.",
    "objective": "Temperature: 39.1°C. Heart rate: 180 bpm. Mild dehydration.",
    "assessment": "Suspected early-stage kidney disease.",
    "plan": "Blood panel ordered. Start IV fluids. Recheck in 48h.",
    "veterinarian": {
      "fp": "user_01JQMKXXXXX",
      "name": "Dr. Ayşe Kaya"
    },
    "clinic": {
      "fp": "clinic_01JQMKXXXXX",
      "name": "Downtown Vet Clinic"
    },
    "exam_date": "2026-04-10T14:30:00+03:00",
    "signed_at": "2026-04-10T15:00:00+03:00",
    "created_at": "2026-04-10T14:00:00Z"
  }
}

SOAP Record Types

Type	Description
`EXAMINATION`	Standard physical examination
`SURGERY`	Surgical procedure note
`VACCINATION`	Vaccination record
`CHECKUP`	Routine checkup
`EMERGENCY`	Emergency visit
`DENTAL`	Dental procedure
`GROOMING`	Grooming session

SOAP Statuses

Status	Description
`DRAFT`	Record in progress, not finalized
`IN_PROGRESS`	Active examination
`SIGNED`	Veterinarian has signed the record
`LOCKED`	Record is locked, no further edits

List SOAP Records by Patient

curl "https://api.vetigen.com/api/v1/soap/patient/patient_01JQMKXXXXX" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

Query Parameters

Parameter	Type	Description
`page`	integer	Page number
`page_size`	integer	Items per page
`status`	string	Filter by status
`type`	string	Filter by SOAP type

Medical Records

On this page