API reference
Reference data
Specialty types, coverage, and your own usage. Free to call.
These endpoints are not billed. They still need an API key.
Specialty types
GET /v2/specialty-types
The values the specialty_type filter accepts on professionals and practices.
{
"data": [
{ "id": "general_practice", "label": "General Practice" },
{ "id": "large_animal", "label": "Large Animal" },
{ "id": "emergency_critical_care", "label": "Specialty- Emergency/Critical Care" }
]
}Jurisdictions
GET /v2/jurisdictions
What the index covers right now.
{
"data": [
{
"code": "CA",
"board_name": "California Veterinary Medical Board",
"verify_url": "https://search.dca.ca.gov/",
"license_count": 49500
},
{
"code": "NJ",
"board_name": "New Jersey State Board of Veterinary Medical Examiners",
"verify_url": "https://newjersey.mylicense.com/verification/Search.aspx?facility=N",
"license_count": 9120
}
]
}The example is shortened to two of the 27 states. These are the values the jurisdiction filter accepts on professionals.
Coverage
GET /v2/coverage
Every US state, the District of Columbia and the territories, with the standing of each role (veterinarian, vet_tech, vet_assistant). Where a role is loaded, people is how many the index holds.
{
"data": [
{
"code": "FL",
"name": "Florida",
"roles": {
"veterinarian": { "state": "loaded", "source": "Florida DBPR veterinary licensee file", "note": "Active and inactive only: void and delinquent licences are not in the file.", "checked": "2026-10-14", "people": 11068 },
"vet_tech": { "state": "not_licensed", "source": null, "note": "Florida does not license technicians.", "checked": "2026-10-14", "people": null },
"vet_assistant": { "state": "unchecked", "source": null, "note": null, "checked": null, "people": null }
}
}
]
}state is one of loaded, open (published openly, not loaded yet), request (available from the board on request), lookup_only (the board offers a one-at-a-time lookup only), blocked (the download is behind a challenge Zuse does not get past), not_licensed, or unchecked.
Certifications
GET /v2/certifications
The specialty certifications the index holds, by the body that grants each, with how many people. These are the values the certification filter accepts. Only some specialty bodies are covered, so this is not a list of every veterinary specialty.
{
"data": [
{ "body": "American Board of Veterinary Practitioners", "title": "Diplomate ABVP", "specialty": "Avian", "people": 11 },
{ "body": "American College of Veterinary Anesthesia and Analgesia", "title": "Diplomate ACVAA", "specialty": "Anesthesia and Analgesia", "people": 28 }
]
}Caching
These lists change rarely, so they are sent with Cache-Control: private, max-age=3600 and an ETag. Send the tag back in If-None-Match and an unchanged list answers 304 Not Modified with no body.
Everything that is billed is the opposite: it is sent with Cache-Control: no-store, because each answer is charged and belongs to one account.
Usage
GET /v2/usage
The credit left for the team the key belongs to, with the current prices and limits. Use it to show a balance in your own product, or to check a limit before a large job.
{
"data": {
"credit": {
"limit_usd": 10.0,
"spent_usd": 1.12,
"remaining_usd": 8.88,
"resets_at": null,
"unlimited": false,
"team_id": "5b0c0e0a-3a52-5c7e-9a55-0c1c6a0f2d11",
"team_name": "Bayside Veterinary Group",
"paid_by": "Dana Reyes",
"is_yours": false
},
"pricing_usd": {
"source": 0.2,
"verify": 0.5,
"enrich": 0.25,
"brief": 0.25,
"web": 0.5,
"contact": 0.6,
"enrich_no_match": 0.0,
"source_included_results": 10,
"source_extra_result": 0.02
},
"limits": {
"per_minute": { "verify": 60, "source": 30, "enrich": 10, "brief": 10, "web": 10, "contact": 20 },
"per_day": { "verify": 1000, "source": 300, "enrich": 100, "brief": 100, "web": 100, "contact": 300 },
"records_per_day": 5000,
"areas_per_day": 40,
"max_page_size": { "professionals": 100, "practices": 100, "licenses": 50 }
}
}
}