Each clinic deployment is its own application and database. The API key works only on the clinic that created it. The request URL is https://{clinic-host}/api/v1/….
api.vetrics.co is not that host. Requests to https://api.vetrics.co/api/v1 return 404. There is no central gateway and no fleet routing header.
Identifiers are UUIDs. Timestamps in responses are UTC ISO-8601. Scheduling date filters use the clinic's local day. Money amounts in the API are decimal strings.
Writes that go through the idempotent adapter require an Idempotency-Key header. A missing key returns 428. Reusing a key with a different body returns 409 CONFLICT. A repeated key with the same body returns the original response.
Appointments and SOAP notes use entity_version. A write without the current version returns 428. A stale version returns 412.
The OpenAPI server variable clinicHost is a placeholder. Substitute the clinic hostname. The path already includes /api/v1.