ZuseDocs
    Console

    Resources

    Changelog

    Changes to the API, the MCP server, and coverage.

    October 2026: v2

    Any VTS (October 26)

    • The certification filter on GET /v2/professionals and the MCP tool source_professionals accepts vts: technicians any academy lists as a Veterinary Technician Specialist, whatever the discipline.

    New prices (October 22)

    • Nearby and Nearby clinics are $0.20 a request with the first 10 records included, then $0.02 for each record after those. The higher fee for records past 50 in one request is gone: every record after the first 10 costs the same.
    • License check is $0.50, Web search $0.50 and Clinic research $0.50. Background ($0.25), Intro notes ($0.25) and Contact ($0.60) are unchanged. Misses stay free, and anything your team already has is still free to read again. See Pricing and metering.

    Zuse profile links in Nearby (October 18)

    • GET /v2/professionals rows carry zuse_profile_url for a person whose record is claimed and checked on Zuse Talent and whose profile is public. People who are listed on no board with a place, but who gave a ZIP code on Zuse Talent, now appear in Nearby at that ZIP code, as reported.

    Professionals join Zuse, and their status ranks Nearby (October 18)

    • Veterinary professionals can now claim their own record on Zuse, free. They say whether they are open to a move, and Nearby lists those who are looking first. GET /v2/professionals carries a new field, open_to_move (actively_looking, open, relief, happy, or null when the person has not claimed their record). Its status is still the licence's status. A professional can also hide from location searches, as if they had asked to be left out.
    • Openings a practice sets to active in Zuse Hiring are published to professionals near them, who can apply in one step. An application arrives as a card on the opening's board, marked "Applied on Zuse", and in the app's notifications; in Slack, @Zuse notify here posts them in a channel.
    • Zuse is now three apps, each with its own sign-in: Zuse Hire (hire.zuse.live) for practices, Zuse Developers (developers.zuse.live) for the console, API keys and MCP, and Zuse Talent (my.zuse.live) for vets, techs and practice staff, with a map search for jobs filtered by place, date, experience, type, pay and perks. Each email is one kind of account. The docs moved to /developers/docs; old links still work.
    • Developer accounts need a work email. A practice that joins with a personal email can run Nearby, License check and Nearby clinics at once, and the rest once Zuse has checked the practice.
    • The referral reward is now once per account: when five new practices join with your link, $10.00 is added, and no more after that. Professionals joining do not count.

    Nearby clinics and clinic research (October 17)

    • GET /v2/clinics lists veterinary clinics near a ZIP code, in one list from three sources: state boards' premises registers (California, Florida, Missouri and West Virginia), clinics where certified practice managers were found to work, and OpenStreetMap in every state. Ask for a kind in plain words (emergency, mobile, shelter, oncology, VCA). Priced like Nearby. See Clinics.
    • GET /v2/clinics/{ref} gives one clinic with the people tied to it: the veterinarian its board names as in charge, its practice managers, and the vets and techs on record at its address.
    • POST /v2/clinic-research researches one clinic's owner, team, phone, email, website, hours and owning group on the public web, $0.25 when found, kept for your team for 30 days. See Clinic research.
    • New MCP tools find_clinics, get_clinic and research_clinic; clinics 85004 emergency and research 2 in Slack; Nearby clinics on the People page.
    • GET /v2/practices is unchanged; new work should use /v2/clinics.
    • Lists are read a page at a time, like a board's look-up. A geographic search (professionals, practices, clinics) lists its nearest 500 records; a cursor past them is refused with 400 search_too_deep, asking to narrow the search. Records past 50 in one request cost $0.01 each (a page of 100 is now $0.60). MCP calls return at most 50. Fifty at a time, nearest first, is unchanged in price.
    • People with no board address. Nearby now also lists people whose board publishes no place (Washington, Arizona, Oregon, Maryland and others) when research or a specialty directory reports their town, marked place_reported.

    Credit that never expires, and referrals (October 16)

    • Every account now gets $10.00 of credit once, when it is made, and it never expires. There is no monthly allowance any more, so nothing resets: resets_at in a 402 and in credit is always null. Spending is counted over the account's whole life.
    • Referrals. Every five people who make a new Zuse account with your link add $10.00 to your credit. Find your link under Referrals in the console, or on Account in the practice view. See Pricing and metering.

    Web searches, Contacts, and new prices (October 16)

    • POST /v2/web-searches finds people no board licenses (groomers, receptionists, kennel staff, practice managers) on their own public profiles near a ZIP code. Only people whose own job title shows the role in animal care, with a stated location inside the radius. See Web searches.
    • POST /v2/contacts finds one person's email and phone from People Data Labs, returns every address and number with its tier (recommended, work, personal, older; mobile, listed), and cross-checks the record against what Zuse holds (confidence). Kept on your team's records like Background. See Contacts.
    • New MCP tools find_people_on_web and find_contact, and contact 3 in Slack.
    • New prices, set from what each request costs us plus a markup: Nearby $0.02 (10 records included, then $0.002 each), License check $0.05, Background $0.25, Intro notes $0.25, Web search $0.20, Contact $0.60. Misses stay free. See Pricing and metering.

    Research is kept, and repeats are free (October 6)

    • Background and Intro notes are kept on your team's records the first time anyone on the team runs them, on any channel: the API, the console, the MCP server, Slack or the workspace. Asking about the same person again returns them with from_records: true at no charge, and does not count towards the research limits. Send "refresh": true to run it again. See Enrichments.
    • POST /v2/enrichments and POST /v2/briefs accept refresh, and their results carry from_records and researched_at or written_at. The MCP tools enrich_person and research_brief take refresh too.
    • Zuse in Slack can create a workspace, shortlist people into it, move them along and read back what is on file, on the same records as the workspace on the web. See Zuse in Slack.
    • The recruiting workspace is per team. Everything saved in it belongs to the team it was saved in.

    Twelve more states, and more specialty bodies (October 15)

    • Alabama, Arkansas, Iowa, Kansas, Maryland, Massachusetts, Michigan, Mississippi, Rhode Island, South Dakota, Vermont and Wisconsin are in the index, from each board's own list or, where a board publishes only a look-up, a list compiled from it by hand: 27 states in all, about 237,000 licenses. Alabama, Kansas and Maryland carry no location and Mississippi a city with no state, so those answer License check only. See Data and provenance.
    • certifications covers more bodies: ophthalmology (ACVO), zoological medicine (ACZM), animal chiropractic (AVCA), canine rehabilitation (CCRT and related), four technician specialty academies, and VHMA's office manager list, as well as ABVP, ACVAA, NAVTA's VTS list, NJVTA and VHMA's practice managers.

    Six more states, and California's discipline (October 15)

    • Arizona, Idaho, Montana, Nevada, Oregon and Wyoming are in the index: about 33,000 more licenses. Wyoming comes from the board's own published rosters; the other five from files downloaded from each board's directory, because their sites refuse programs. Montana and Wyoming carry city and ZIP code and appear in Nearby; Arizona, Nevada and Oregon carry no location, and Idaho few, so those answer License check only. See Data and provenance.
    • Nevada publishes names, category and standing only. Its records have no license_number and status: "unknown".
    • California board actions: licenses now carry board_actions, each action the Veterinary Medical Board has published since 2020, with its date, the board's words and a link to its document.
    • Specific roles have their own profession: euthanasia_technician, reproductive_technician (artificial insemination, embryo transfer), equine_dental_technician, animal_chiropractor, animal_physical_therapist, vet_professional_associate. A License check finds them by name or number; GET /v2/professionals lists them when profession names one, and keeps to veterinary staff when it is omitted.
    • People are joined across more of their licenses: by the same license number, by license type within a state when there is no address, and, marked as likely, by a name nobody else holds. GET /v2/people/{id} carries linked_by, and an id that was joined into another still answers. See People.
    • License check matches a long double surname from one part, ignores accents, and finds a license from its digits when the board's prefix is left off (with a note that says so).
    • Washington adds technician trainees and temporary technician permits, and keeps its specialty license under its own name. Colorado is ready for Veterinary Professional Associates, who register from 2026.

    Seven more states, technician specialists and coverage (October 14)

    • Colorado, Connecticut, Florida, Illinois, Missouri, Washington and West Virginia are in the index, from each state's board or its open-data copy: about 92,000 more licenses. Colorado, Illinois, Missouri, Washington and West Virginia include veterinary technicians; Washington's veterinary medication clerks count as vet_assistant. Connecticut and Florida, like New Jersey, do not license technicians. See Data and provenance.
    • Washington's file has no addresses, so its licenses answer License check but not Nearby. Missouri and West Virginia publish current licenses only.
    • GET /v2/coverage gives every state's standing for veterinarians, technicians and assistants. See Reference data.
    • certifications can now carry NAVTA's Veterinary Technician Specialist (VTS) list. The ABVP and ACVAA directories are matched in every state in the index.
    • Illinois records are used under the Open Data Commons ODbL, with attribution to the Illinois Department of Financial and Professional Regulation.

    New Jersey, board actions, and specialty certifications (October 13)

    • New Jersey veterinarians are in the index: 9,120 licenses of every status, from the state's Division of Consumer Affairs. New Jersey does not license veterinary technicians, so there are none.
    • New statuses and red flags. status can now be surrendered or deceased, and red_flags can carry license_surrendered, holder_deceased and board_action_on_record. The last means the board's own file marks the license as having a disciplinary or other action; it can appear on an active license. New Jersey only: California's roster does not publish it.
    • certifications on every license and professional: what a veterinary specialty body's directory lists the person as. Two bodies are covered. An empty list means none was found.
    • Two new filters on GET /v2/professionals and the MCP tool source_professionals: jurisdiction (the state that issued the license) and certification (any, or a specialty). A value the index does not hold is an error that names the ones it does.
    • GET /v2/certifications lists what is held.
    • People licensed in both states are one person with two licenses.

    MCP: ten at a time, and a license number is enough (October 6)

    • source_professionals returns 10 people when limit is not given (it was 50), and each answer carries remaining. The assistant shows ten and offers the next ten. A limit of up to 100 still works. The REST API's default page is unchanged.
    • verify_license accepts a license_number with no name, as GET /v2/licenses already did. A call with neither is an invalid_arguments error.

    MCP tools are stricter (October 6)

    • source_professionals requires a location, and profession on it and on verify_license accepts only the listed values. An unlisted value used to return an empty result; it is now an invalid_arguments error that names the listed ones.
    • An argument a tool does not have is refused instead of ignored, and an invalid sort or practice_type returns a tool error (it used to fail with a 500).
    • tools/list now carries a description for every argument, a title and annotations for each tool.

    API

    • New resource-style API under /v2: GET /v2/professionals, GET /v2/practices, GET /v2/licenses, GET /v2/licenses/{id}, GET /v2/people/{id}, GET /v2/people/{id}/licenses, POST /v2/enrichments, GET /v2/enrichments/{id}, GET /v2/specialty-types, GET /v2/jurisdictions, GET /v2/usage.
    • Lists return everyone. Professionals, practices and license searches page with cursor, so a search returns every match in the radius rather than the nearest few. Up to 100 per page.
    • Sorting on professionals: distance, years_licensed, -years_licensed, name.
    • License search by license_number, alone or with a name.
    • One response envelope and one error shape, with a stable code and a request_id.
    • Idempotency-Key on every metered call: a retry is not charged again.
    • Enrichments can be created from a license_id and fetched again by id for 24 hours.
    • ISO 8601 dates.

    Limits

    • Rate limits are now enforced: per minute and per day by operation, records per day, distinct search areas per day, and per address. Responses carry RateLimit-* headers, and a 429 carries Retry-After.
    • Accounts that repeatedly run into the limits are restricted automatically.

    Pricing (October 5)

    • Nearby is priced by what a request returns: $0.007 per request with the first 10 records included, then $0.001 for each record after those. A full request of 100 records is $0.097, close to the earlier flat $0.10, and a small search now costs under a cent. License check ($0.02) and Background ($0.18) are unchanged.
    • Credit is held by the team. A request is paid for by the team it is made in, and everyone on the team draws on one balance. A team's credit is its owner's $10.00 a month, so inviting people does not add credit.

    Zuse in Slack (October 5)

    • New: connect a Slack workspace from the console, then mention @Zuse, message it directly, or use /zuse. Follow-ups in a thread need no mention. Charged to the connected team. See Zuse in Slack.

    Briefs (October 5)

    • New: POST /v2/briefs writes a recruiter's intro notes on one person (a summary, recent changes that make a reach-out timely, and talking points), and GET /v2/briefs/{id} returns it for 24 hours. Metered as its own operation (brief), and free when there is not enough to write one. Also available as the MCP tool research_brief and in the console.

    v1 (October 5)

    • Retired. Every /v1 path answers 410 with the code version_retired. See Versioning for the matching v2 resource.

    MCP

    • source_professionals and verify_license accept cursor and return next_cursor.
    • Limit and credit errors are returned as tool errors with the HTTP status and retry_after_seconds.

    October 2026: v1

    Initial release. This version has since been retired.

    API

    • Every account gets $10.00 of credit each month, shared by the API, MCP and console. Calls stop with 402 when it runs out.
    • POST /v1/verify: check a person against the board of record.
    • POST /v1/source: list licensed professionals near a location. Filters for license type, years licensed, and practice type; profession: "premises" lists practices.
    • POST /v1/enrich: cited, web-derived context for one person.
    • API key authentication, with keys managed in the console.
    • Per-call metering. License misses and empty results are not charged.

    MCP

    • MCP server at /mcp over stateless streamable HTTP, with the tools verify_license, source_professionals, and enrich_person.

    Coverage

    • California: veterinarians, registered veterinary technicians, and veterinary assistant permit holders.