Licenses | Zuse Docs

Check a person against the licensing board of record, by name, license number, or both.

GET /v2/licenses

Searches the verified index and returns ranked licenses with number, status, expiry, and red flags. Name matching is fuzzy, so partial names and small misspellings still resolve. Priced as License check.

Search

bash

curl -G https://api.zuse.live/v2/licenses \
  -H "Authorization: Bearer $ZUSE_KEY" \
  --data-urlencode "name=Jane Doe" \
  -d jurisdiction=CA \
  -d profession=veterinarian

Parameter	Type	Description
`name`	string	Full or partial name. Required unless `license_number` is sent.
`license_number`	string	Exact license number. Alone, it returns every license with that number; with `name`, it narrows the name match.
`jurisdiction`	string	Two-letter state code, such as `CA`. Omit to search every indexed jurisdiction.
`profession`	string	`veterinarian`, `vet_tech`, `vet_assistant`, or a specific role such as `euthanasia_technician` (see the `profession` field below). Omit to search every licensed person.
`limit`	integer	Matches per page, 1 to 50. Default `10`.
`cursor`	string	`pagination.next_cursor` from the previous page.

Names are personal data, and query strings can be recorded by proxies between you and us. If that matters in your environment, use the MCP verify_license tool, which carries the same search in the request body. Zuse does not write query strings to its own logs either way.

Response

json

{
  "data": [
    {
      "id": 48211,
      "person_id": 12821,
      "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/",
      "match_score": 1.0
    }
  ],
  "pagination": { "limit": 10, "has_more": false, "next_cursor": null },
  "meta": {
    "outcome": "found",
    "note": null,
    "jurisdiction": "CA",
    "covered_jurisdictions": ["CA"],
    "board_verify_url": null
  },
  "billing": { "operation": "verify", "cost_usd": 0.02, "credit_remaining_usd": 9.98 }
}

Outcome

meta.outcome says what happened, so a miss is never ambiguous.

Value	Meaning	Billed
`found`	One or more licenses matched. `data` is ordered best first.	Yes
`no_match`	The jurisdiction is indexed, but nothing matched. Check the spelling, or a middle or maiden name.	No
`jurisdiction_not_indexed`	The requested jurisdiction is not covered yet. `meta.board_verify_url` points to the board's own lookup when one is known.	No

The license object

Field	Description
`id`	Identifier of this license record. Use it with `GET /v2/licenses/{id}` and as `license_id` on an enrichment.
`person_id`	The person this license belongs to. Licenses held by the same person share it. See People.
`name`	Name as recorded by the board.
`profession`	Normalized profession: `veterinarian`, `vet_tech`, `vet_assistant`, or a specific role: `euthanasia_technician`, `reproductive_technician` (artificial insemination, embryo transfer), `equine_dental_technician`, `animal_chiropractor`, `animal_physical_therapist`, `vet_professional_associate`. A License check searches all of them.
`credential`	Normalized credential, such as `DVM` or `RVT`, when one applies.
`jurisdiction`	Two-letter code of the issuing board.
`license_number`	License number as issued.
`license_type`	The board's own label for the license.
`status`	`active`, `expired`, `inactive`, `revoked`, `suspended`, `surrendered`, `probation`, `deceased`, or `unknown`. Which of these a state can show depends on what its board publishes: California's and Connecticut's files carry only the first three, Florida's only `active` and `inactive`, and Missouri's and West Virginia's only `active`. Nevada's register gives no status, so its records are `unknown`. See Data and provenance.
`is_active`	`true` only when the license is currently active.
`issued_on`, `expires_on`	Dates as published by the board, in ISO 8601. `null` when the board gives none.
`years_licensed`	Whole years since `issued_on`.
`city`, `state`	Address of record locality. Street addresses are not returned.
`red_flags`	Zero or more of the flags below.
`board_actions`	What the board published about this license, newest first: `kind` (such as `citation`, `accusation`, `probation`, `revocation`, `surrender`), `date`, `summary` (the board's own words) and `document_url`. California only; empty elsewhere, including where a state gives only the `board_action_on_record` mark. An `accusation` is an allegation, not a finding.
`certifications`	What a veterinary specialty body's directory lists the person as. An empty list means none was found, not that the person has none. See Certifications.
`verify_url`	The board's public lookup, for independent confirmation.
`match_score`	Search results only. Name similarity from 0 to 1; `1.0` is an exact match. `null` when the search was by license number alone.

Red flags

Flag	Raised when the license is
`license_expired`	past its expiry date
`license_inactive`	marked inactive by the board (in New Jersey this includes retired and paid-inactive)
`license_surrendered`	given up by its holder
`holder_deceased`	recorded by the board as deceased
`board_action_on_record`	marked in the board's own file as having a disciplinary or other board action. The file does not say what the action was or when; follow `verify_url` for the detail. It can appear on an active license. Colorado, Idaho, Illinois, New Jersey, Washington, West Virginia and Wyoming publish it in their files, and Nevada marks registrants with notices or restrictions; California publishes each action since 2020 on its own pages, and those licenses carry `board_actions` too. Connecticut, Florida and Missouri publish neither.
`license_revoked`	revoked
`license_suspended`	suspended
`license_probation`	on probation

Get one license

GET /v2/licenses/{id}

bash

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

Returns { "data": { ...license }, "billing": { ... } }. Billed at the License check price. An unknown id is a 404 and is free.

Choosing a match

Several people can share a name. Use match_score, city, and profession to pick the right one, and treat a low score as a prompt to confirm rather than as an answer. When you already know the state, pass jurisdiction. When you already know the license number, pass it: it is the most precise search there is.

Billing

A search page with one or more matches is billed once at the License check price. A miss is free.