Clinics | Zuse Docs

Veterinary clinics near a ZIP code, from the boards that register them, practice managers' clinics and OpenStreetMap, as one list.

GET /v2/clinics · GET /v2/clinics/{ref}

A clinic list has three sources. Each clinic appears once, and source says whose record it is:

`source`	What it is
`board`	A state board's register of veterinary premises: California, Florida, Missouri and West Virginia today. Carries the board's premises licence (`licence`); in Florida and West Virginia the veterinarian responsible, and in West Virginia the clinic's phone.
`vhma`	A clinic where a certified practice manager (CVPM or CVOM, from VHMA's list) was found to work. Reported, with its source.
`osm`	A clinic as OpenStreetMap maps it, in every state. Show `attribution` ("© OpenStreetMap contributors") wherever you show one.

When a board's clinic and OpenStreetMap's are the same clinic, the board's record leads and OpenStreetMap adds the exact point, phone, website and hours.

List clinics near a place

bash

curl -G https://api.zuse.live/v2/clinics \
  -H "Authorization: Bearer $ZUSE_KEY" \
  -d postal_code=85004 \
  -d radius_miles=10 \
  -d kind=emergency

Parameter	Type	Description
`postal_code`	string	US ZIP code. Used when coordinates are omitted.
`latitude`, `longitude`	number	Centre point. Takes precedence over `postal_code`.
`radius_miles`	number	Search radius, up to 250. Default `25`.
`kind`	string	What kind of clinic, in plain words. Omit for every clinic. See below.
`sort`	string	`distance` (default) or `name`.
`limit`	integer	Clinics per page, 1 to 100. Default `25`.
`cursor`	string	`pagination.next_cursor` from the previous page.

kind reads the words people use:

Words	Lists
clinics, vet, animal hospital, practice	every clinic
general practice, primary care	general practices
emergency, ER, 24 hour, urgent care	emergency and urgent care
specialty, specialist, referral	specialty and referral hospitals
oncology, cardiology, dentistry, surgery, neurology, dermatology, ophthalmology, internal medicine, radiology	that specialty
mobile, house call, ambulatory	mobile practices
shelter, humane society, SPCA, rescue, low cost	shelters and rescues
equine, horse, large animal, farm, mixed	equine and large animal
exotic, avian, bird, reptile	exotic and avian
cat, feline	cat clinics
VCA, Banfield, BluePearl, NVA, Vetcor, ...	that group's clinics

Any other words are looked for in clinic names. A kind is what a clinic's name or its board's register states, not a check of anyone's certification. meta.kind.read_as says how the words were read.

Response

json

{
  "data": [
    {
      "ref": "p_5973",
      "name": "Example Animal Hospital",
      "legal_name": null,
      "kinds": ["General Practice"],
      "address": "100 Example St",
      "city": "Parkersburg",
      "state": "WV",
      "zip": "26101",
      "phone": "(304) 555-0100",
      "website": null,
      "hours": null,
      "licence": { "jurisdiction": "WV", "number": "0412", "active": true },
      "source": "board",
      "source_url": "https://services.wvbvm.org/verify/",
      "osm_ref": null,
      "attribution": null,
      "distance_miles": 1.37,
      "latitude": 39.2667,
      "longitude": -81.5615,
      "exact_point": false,
      "people_named": 1
    }
  ],
  "pagination": { "has_more": true, "next_cursor": "eyJvIjoyNX0", "total": 13 },
  "meta": {
    "center": { "latitude": 39.27, "longitude": -81.56 },
    "radius_miles": 10,
    "sort": "distance",
    "kind": { "asked": null, "read_as": "Clinics" },
    "total": 13,
    "attribution": { "text": "© OpenStreetMap contributors", "url": "https://www.openstreetmap.org/copyright" }
  },
  "billing": { "operation": "clinics", "cost_usd": 0.02, "credit_remaining_usd": 9.98 }
}

Field	Description
`ref`	The clinic's reference: `p_` for a board's or a manager's clinic, `osm_` for OpenStreetMap's. Use it with `GET /v2/clinics/{ref}` and clinic research.
`legal_name`	Who the clinic is registered to, when it trades under another name ("Vetcor Of California Lp").
`exact_point`	`true` when the point is the clinic's own (OpenStreetMap's); `false` when it is its ZIP code's middle.
`people_named`	How many people a record ties to it: the veterinarian in charge and practice managers.

One clinic and its people

bash

curl https://api.zuse.live/v2/clinics/p_5973 -H "Authorization: Bearer $ZUSE_KEY"

Returns the clinic with people:

`role`	Who
`responsible`	The veterinarian the board names as in charge of the premises.
`manager`	A practice manager (CVPM or CVOM) whose clinic research found. `source: "reported"`.
`on_record`	Active vets and techs whose board record gives this clinic's street address, with `license_id`.

Billing

A list is priced like Nearby: $0.20 a request including the first 10 clinics, then $0.02 for each one after those. A search lists its nearest 500 clinics; narrow it to see others. A page with no clinic on it is free. One clinic with its people is priced as one License check ($0.50); an unknown ref is free. Up to 30 lists a minute and 300 a day. See Pricing and metering.

GET /v2/practices still answers as before (registered premises only); new work should use /v2/clinics.