Ship the integration this week.

REST + webhooks, OAuth and service tokens, TypeScript and Python SDKs, a sandbox seeded with a real clinic. Three steps to your first webhook below.

1. 1
   Authenticate

   Install the SDK and set your key.

   Service tokens are easiest for backend integrations. OAuth is required for end-user-facing apps.

   terminalcurl

   1# Install the SDK
   2npm install @vetch/sdk        # or: pip install vetch-sdk
   3 
   4# Export your sandbox token (never commit this).
   5export OTIS_API_KEY='sk_sandbox_2k8jqx…'

2. 2
   First call

   List today's appointments.

   Cursor-paginated, JSON, idempotent. The same call works in sandbox and production with a different key.

   POST /v1/appointments.listTypeScript

   1import { Vetch } from '@vetch/sdk'
   2 
   3const vetch = new Vetch({ apiKey: process.env.OTIS_API_KEY })
   4 
   5const page = await vetch.vetointments.list({
   6  on: 'today',
   7  limit: 50,
   8})
   9 
   10// → { data: [{ id: 'appt_…', start: '2026-05-12T14:30Z', … }, …], next_cursor: '…' }

3. 3
   Subscribe

   Catch a webhook the moment a chart signs.

   Signed payloads (HMAC-SHA256), automatic retries with exponential backoff, 30-day replay.

   POST /your-app/vetch-eventsTypeScript

   1import { verifyWebhook } from '@vetch/sdk'
   2 
   3export async function POST(req: Request) {
   4  const event = await verifyWebhook(req, process.env.OTIS_WEBHOOK_SECRET)
   5 
   6  if (event.type === 'chart.signed') {
   7    // event.data is the full chart payload, signed and timestamped.
   8    await postToReferringDvm(event.data)
   9  }
   10 
   11  return new Response('ok', { status: 200 })
   12}