Professionals

GET /v2/professionals

Returns the licensed population inside a radius: everyone the board has on record there, not only people who are looking for work, nearest first. A search lists its nearest 500; follow the pages to get them. The call is read-only and is priced as Nearby.

Request

curl -G https://api.zuse.live/v2/professionals \
  -H "Authorization: Bearer $ZUSE_KEY" \
  -d postal_code=90013 \
  -d radius_miles=10 \
  -d profession=veterinarian \
  -d sort=distance \
  -d limit=100

Give the center either as a ZIP code or as coordinates.

Response

{
  "data": [
    {
      "id": 48211,
      "person_id": 30412,
      "name": "JANE DOE",
      "profession": "veterinarian",
      "credential": "DVM",
      "jurisdiction": "CA",
      "license_number": "16364",
      "license_type": "Veterinarian",
      "status": "active",
      "is_active": true,
      "issued_on": "2018-07-06",
      "expires_on": "2027-08-31",
      "years_licensed": 8,
      "city": "LOS ANGELES",
      "state": "CA",
      "red_flags": [],
      "verify_url": "https://search.dca.ca.gov/",
      "distance_miles": 0.4,
      "latitude": 34.0448,
      "longitude": -118.2434,
      "practice": {
        "id": 51877,
        "name": "EXAMPLE PET EMERGENCY CLINIC",
        "license_number": "5123",
        "specialty_types": ["emergency_critical_care"]
      }
    }
  ],
  "pagination": { "limit": 100, "has_more": true, "next_cursor": "eyJvIjoxMDAsInEiOiI0ZjJhIn0", "total": 598 },
  "meta": { "center": { "latitude": 34.0453, "longitude": -118.2413 }, "radius_miles": 10, "sort": "distance" },
  "billing": { "operation": "source", "cost_usd": 0.1, "credit_remaining_usd": 9.9 }
}

Each item is a license, plus:

Paging through a search

A licensed professional can ask to be left out of location searches; they are then absent from the results, the total and the map alike. Looking up a license by name or number is not affected.

pagination.total is how many people match. Keep requesting with cursor set to the previous pagination.next_cursor until has_more is false. A search lists its nearest 500, the way a board's own look-up shows a page at a time: past them has_more is false, and a cursor beyond them is refused with 400 search_too_deep. To see others, narrow the search: a smaller radius, one profession, or one jurisdiction. Ten miles around downtown Los Angeles holds about 600 veterinarians; the nearest 500 are ten requests of 50, $0.20 in all.

Each request is charged by the number of people it returns: $0.20 with the first 10 included, then $0.02 for each person after those. See Pricing and metering.

Experience

min_years_licensed and max_years_licensed filter on the board's issue date for the license, which every record has. max_years_licensed=3 returns people licensed in the last three years; min_years_licensed=10 returns people licensed for a decade or more. This is time since this license was issued in this jurisdiction, not total career length: someone who moved from another state looks newer than they are.

Specialty type

specialty_type means the type of patients a practice sees, or its specialty. The values are:

Where the type comes from

Licensing boards do not record what kind of practice a premises is, and they do not record anyone's board certification. Zuse does not invent either. The type is derived from two things a board does record:

• A practice's registered name. "Bay Area Equine Hospital" is large_animal; "Veterinary Cancer Group" is oncology; "Pet Emergency and Specialty Center" is emergency_critical_care and specialty_referral. In California, about one practice in five states a type this way.
• General Practice is inferred. A practice with an ordinary clinic name ("San Dimas Animal Hospital") that states no other type is classed general_practice. This is the least certain type. A practice whose name fits nothing has no type at all.
• A university license places its holder in education_teaching directly.

A person is tied to a practice only when their address on record is that practice's address. Many licensees register a home or mailing address, so the link exists for a minority of people (roughly one veterinarian in six in California).

So specialty_type behaves differently depending on what you ask for:

This is not a board-certification check. A "Specialty-" type says the person's practice of record presents itself that way. It does not confirm that the person is a diplomate of a specialty college. Background returns stated credentials for one person from the public web, as a derived finding.

Location precision

Records are geocoded to the postal code of the address of record, not to a street address. Everyone in the same ZIP code shares one point, and distance_miles is the distance to that point. Treat distances as accurate to within a ZIP code, and do not treat the coordinates as a home or work location.

Billing

A page with one or more people on it is billed once at the Nearby price, whatever the limit. A page with nobody on it is free.

Errors

Certifications

Each person carries a certifications list: what a veterinary specialty body's own public directory says about them.

"certifications": [
  {
    "body": "American Board of Veterinary Practitioners",
    "title": "Diplomate ABVP",
    "specialty": "Avian",
    "practice": "Example Bird Hospital",
    "website": "https://example.org/",
    "seen_on": "2026-10-13",
    "source": "https://abvp.connect.prolydian.com/all-members"
  }
]

Read it with three things in mind:

• It comes from the specialty body, not the licensing board. source is the directory it was read from and seen_on is the day. It never changes a person's profession, which comes only from the license.
• An empty list means none was found. It does not mean the person has none. Two bodies are covered today: the American Board of Veterinary Practitioners and the American College of Veterinary Anesthesia and Analgesia. A cardiologist, a surgeon or an oncologist will show an empty list, because those bodies are not covered yet. GET /v2/certifications lists exactly what is held.
• A certification is attached only when the match is not in doubt: one veterinarian of that name licensed in the state the directory lists them in, or one in the listed city when several share the name. Otherwise it is left off.

certification=any keeps people with at least one. certification=vts keeps technicians with any VTS. certification=Avian keeps people with that one. A value the index does not hold is a 400 that names the ones it does, never an empty result.