Practices | Zuse Docs

GET /v2/practices

Returns registered premises (hospitals, clinics, mobile practices) inside a radius. Priced as Nearby.

Request

bash

curl -G https://api.zuse.live/v2/practices \
  -H "Authorization: Bearer $ZUSE_KEY" \
  -d postal_code=90013 \
  -d radius_miles=15 \
  -d specialty_type=emergency_critical_care

Parameter	Type	Description
`postal_code`	string	US ZIP code. Used when coordinates are omitted.
`latitude`, `longitude`	number	Center point. Takes precedence over `postal_code`.
`radius_miles`	number	Search radius, up to 250. Default `25`.
`specialty_type`	string	A value from `GET /v2/specialty-types`.
`status`	string	`active` (default) or `any`.
`sort`	string	`distance` (default) or `name`.
`limit`	integer	Practices per page, 1 to 100. Default `50`.
`cursor`	string	`pagination.next_cursor` from the previous page.

Response

json

{
  "data": [
    {
      "id": 51877,
      "name": "EXAMPLE PET EMERGENCY CLINIC",
      "jurisdiction": "CA",
      "license_number": "5123",
      "license_type": "Veterinary Premises",
      "status": "active",
      "is_active": true,
      "issued_on": "2009-03-12",
      "expires_on": "2027-05-31",
      "city": "LOS ANGELES",
      "state": "CA",
      "specialty_types": ["emergency_critical_care"],
      "distance_miles": 1.2,
      "latitude": 34.0522,
      "longitude": -118.2437,
      "verify_url": "https://search.dca.ca.gov/"
    }
  ],
  "pagination": { "limit": 50, "has_more": false, "next_cursor": null, "total": 21 },
  "meta": { "center": { "latitude": 34.0453, "longitude": -118.2413 }, "radius_miles": 15, "sort": "distance" },
  "billing": { "operation": "source", "cost_usd": 0.1, "credit_remaining_usd": 9.9 }
}

specialty_types holds the types the practice's registered name states. It can be empty: about one California practice in five states a type in its name, and General Practice is inferred for ordinary clinic names. See where the type comes from.

A practice's id is what practice.id on a professional refers to.

Billing

A request that returns practices is charged at the Nearby price: $0.20 with the first 10 included, then $0.02 for each practice after those. A request that returns none is free.