API Reference

The Shepherd API is a JSON REST API for building integrations on top of the Shepherd practice-management platform: labs, imaging, pharmacy, fintech, AI, and anything else a modern clinic plugs into.

Live API reference

Authoritative request and response schemas for every endpoint are published in the live Swagger UI at app.shepherd.vet/swagger/.

This site complements the Swagger with concepts, conventions, end-to-end tutorials, and code samples in curl, Python, C#, PHP, and JavaScript.

At a glance

• Production: https://open-api.shepherd.vet/pav2/
• Sandbox: https://demo-open-api.shepherd.vet/pav2/
• Transport: every endpoint is POST with Content-Type: application/json, even reads.
• Auth: dual API-key headers (X-Integration-Public-Key, X-Integration-Private-Key) plus a per-clinic X-Clinic-Id.

Where to next

• Overview: environments, transport, and HTTP-client guidance.
• Authentication: API keys, the per-clinic scope model, and a working “hello world”.
• Conventions: pagination, embedding, sorting, date filters, and the collection envelope.
• Errors: status codes and the two JSON error shapes.
• Rate limits: per-minute and per-hour caps, querying current usage, and backoff guidance.

New to the platform? Start with the first-integration tutorial and you’ll be reading live data in about ten minutes.