API reference
Allied Verify API · v1
Search and verify allied-health licenses and credentials (physical therapy, occupational therapy, respiratory care, speech-language pathology, audiology and athletic training) from official state sources.
Authenticate with an API key: Authorization: Bearer avk_.... Create keys on your account page. Each verification uses one credit, including every license-number check. Name search, coverage and source metadata are free.
This API reports what official sources publish at a point in time. It does not monitor credentials continuously.
This point-in-time check does not provide an FCRA background report or NCQA-certified primary source verification. How we verify
Quick start
export ALLIED_VERIFY_KEY=avk_... # from /account
curl -X POST https://www.alliedverify.com/v1/verifications \
-H "Authorization: Bearer $ALLIED_VERIFY_KEY" \
-H "Content-Type: application/json" \
-d '{"jurisdiction":"CO","license_number":"PTL.12345","credential_type":"pt"}'Base URL: https://www.alliedverify.com. Send and receive JSON. Timestamps are ISO 8601 in UTC. Dates are YYYY-MM-DD. Lists use cursor pagination: pass next_cursor as starting_after.
Errors
Errors use HTTP status codes and one JSON shape. Branch on error.type, not on the message.
{
"error": {
"type": "insufficient_credits",
"message": "No verification credits remain. Buy a plan or top up."
}
}Versioning
The version is in the path. Within v1 we only add fields, endpoints and enum values; we never remove or rename them. Treat unknown enum values as unknown. Specialty-specific data goes in credential.attributes, so new professions and states do not change the shape.
Verifications
Paid checks that return a frozen credential snapshot with provenance.
Submit a verification batch
Submit up to 500 rows (256 KiB max). Each row accepts the same fields as a single verification, including your optional reference. Invalid and unsupported rows are kept with their errors and use no credits. Background processing uses the organization's normal verification credits. A completed not_found uses one credit. When the balance runs out, the batch skips the remaining queued rows. Existing pending lookups can still finish.
| Parameter | In | Description |
|---|---|---|
rows | body |
curl -X POST https://www.alliedverify.com/v1/batches \
-H "Authorization: Bearer $ALLIED_VERIFY_KEY" \
-H "Content-Type: application/json" \
-d '{"rows":[{"jurisdiction":"WA","license_number":"PT60512345","reference":"candidate-1042"}]}'Responses: 202 Accepted for background processing. 400 Invalid batch body or row count. 401 Missing or invalid API key. 413 The body exceeds 256 KiB. 429 Too many requests.
Retrieve batch results
Poll every 10 seconds while the batch is processing. Returns all rows in submission order. Completed and stopped batches are terminal.
| Parameter | In | Description |
|---|---|---|
id | path |
curl https://www.alliedverify.com/v1/batches/wa-doh \ -H "Authorization: Bearer $ALLIED_VERIFY_KEY"
Responses: 200 Current batch results. 401 Missing or invalid API key. 404 No batch in the API key's organization. 429 Too many requests.
Verify a credential
Uses one credit from the API key’s organization and includes OIG LEIE and SAM.gov exclusion screening. Returns 201 with status: completed when we already hold a current credential. Returns 202 with status: pending when the source needs a live lookup, or when a Florida license has no fetched detail page yet (dates and public actions come only from that page); poll GET /v1/verifications/{id} every few seconds until it completes. Pennsylvania name queries search previously checked records. Use the full license number to look up a new Pennsylvania credential. If a live lookup fails, the verification fails and the credit is refunded. A completed not_found outcome uses the credit.
| Parameter | In | Description |
|---|---|---|
credential_id | body | Credential id from GET /v1/credentials. |
jurisdiction | body | Two-letter state code. |
license_number | body | License number. For North Carolina, Ohio and Pennsylvania, send the full number with its letters and leading zeros. Other sources may match by digits. |
first_name | body | First name for a name verification. Supports common nicknames and can include a middle name or initial. |
middle_name | body | Optional middle name or initial for a name verification. |
last_name | body | Full last name for a name verification. Ignores case, accents, spaces and punctuation. |
city | body | Filter by normalized board-published city when verifying by name or license number. |
county | body | Filter by board-published county where available. The County suffix is optional. |
credential_type | body | Narrow the match to one credential type. Required with a North Carolina license number to select the correct board. One of: pt pta ot ota rt slp slpa aud auda at mrt nct ra pmrt mp perf sa rd dt dp hid po poa |
npi | body | Optional National Provider Identifier for registry matching and federal exclusion screening. For name verification it also requires a board NPI or a current NPPES link to the same license number and issuing state. A confirmed match can also narrow a license-number conflict. |
reference | body | Your own id for this check (for example a candidate id). Max 200 characters. |
curl -X POST https://www.alliedverify.com/v1/verifications \
-H "Authorization: Bearer $ALLIED_VERIFY_KEY" \
-H "Content-Type: application/json" \
-d '{"jurisdiction":"WA","license_number":"PT60512345","credential_type":"pt","reference":"candidate-1042"}'Responses: 201 Completed verification. 202 Pending live lookup. 400 Invalid request. 401 Missing or invalid API key. 402 No credits remain. 404 Unknown credential_id. 409 More than one credential matches. The response includes masked candidates and suggested fields. No credit is used. 422 The jurisdiction or credential type is not covered. No credit is used.
Example response
{
"object": "verification",
"id": "ver_2h6k9m1n4p7q0r3s5t8v1w4x6y",
"status": "completed",
"outcome": "found",
"reference": "candidate-1042",
"request": {
"jurisdiction": "WA",
"license_number": "PT60512345",
"credential_type": "pt"
},
"credential": {
"object": "credential",
"id": "cred_4k2m9q0d7f3h1j5n8p6r2t4v0w",
"jurisdiction": {
"code": "WA",
"name": "Washington"
},
"profession": {
"code": "physical_therapy",
"name": "Physical therapy"
},
"credential_type": {
"code": "pt",
"name": "Physical Therapist"
},
"credential_class": {
"code": "license",
"name": "License"
},
"native_type": "Physical Therapist License",
"license_number": "PT.PT.60512345",
"holder": {
"full_name": "Jordan A Rivera",
"first_name": "Jordan",
"middle_name": "A",
"last_name": "Rivera",
"suffix": null
},
"status": {
"code": "active",
"name": "Active",
"native": "Active",
"is_active": true
},
"dates": {
"first_issued_on": "2019-06-14",
"last_renewed_on": "2025-05-02",
"expires_on": "2027-05-02"
},
"discipline": {
"has_public_action": false,
"actions": []
},
"location": {
"city": null,
"region": null,
"postal_code": null
},
"attributes": {
"ce_due_on": "2027-05-02"
},
"documents": [
{
"kind": "search_page",
"url": "https://wahelms.my.site.com/s/license-search",
"title": "WA DOH license search"
}
],
"provenance": {
"source_id": "wa-doh",
"authority": "Washington State Department of Health",
"verification_level": "primary_source",
"statement": "The department states this data is a primary source for verification of credentials.",
"source_url": "https://wahelms.my.site.com/s/license-search",
"observed_at": "2026-11-18T14:02:11.000Z",
"source_as_of": "2026-11-18T10:00:00.000Z",
"first_seen_at": "2026-11-18T14:02:11.000Z",
"last_changed_at": "2026-11-18T14:02:11.000Z",
"record_hash": "9f2c…"
}
},
"exclusion_check": {
"status": "no_match",
"match_method": null,
"source_as_of": "2026-10-31T00:00:00.000Z",
"matches": [],
"has_more_matches": false,
"sam_gov": {
"status": "no_match",
"match_method": null,
"source_as_of": "2026-11-18T00:00:00.000Z",
"matches": [],
"has_more_matches": false
}
},
"credits_charged": 1,
"failure_reason": null,
"created_at": "2026-11-18T14:05:00.000Z",
"completed_at": "2026-11-18T14:05:00.000Z"
}List verifications
Lists verification history for the API key’s organization.
| Parameter | In | Description |
|---|---|---|
q | query | Substring of the saved holder name or the saved or requested license number. Ignores case for A–Z. |
jurisdiction | query | Two-letter issuing state code. |
status | query | Verification processing status. One of: pending completed failed |
outcome | query | Verification result. One of: found not_found |
credential_status | query | License status in the saved report. One of: active active_restricted probation inactive expired suspended revoked surrendered pending denied unknown |
reference | query | Exact, case-sensitive customer reference. |
from | query | First creation date to include (UTC). |
to | query | Last creation date to include (UTC). |
sort | query | Order by creation date. Default newest. One of: newest oldest |
limit | query | 1–100. Default 25. Larger values return 100. Other values return 400. |
starting_after | query | Cursor from a previous page with the same filters and sort. A malformed cursor returns 400. |
curl https://www.alliedverify.com/v1/verifications \ -H "Authorization: Bearer $ALLIED_VERIFY_KEY"
Responses: 200 Matching verifications, ordered by creation date. 400 Invalid filter or date range.
Example response
{
"object": "list",
"data": [
{
"object": "verification",
"id": "ver_2h6k9m1n4p7q0r3s5t8v1w4x6y",
"status": "completed",
"outcome": "found",
"reference": "candidate-1042",
"request": {
"jurisdiction": "WA",
"license_number": "PT60512345",
"credential_type": "pt"
},
"credential": {
"object": "credential",
"id": "cred_4k2m9q0d7f3h1j5n8p6r2t4v0w",
"jurisdiction": {
"code": "WA",
"name": "Washington"
},
"profession": {
"code": "physical_therapy",
"name": "Physical therapy"
},
"credential_type": {
"code": "pt",
"name": "Physical Therapist"
},
"credential_class": {
"code": "license",
"name": "License"
},
"native_type": "Physical Therapist License",
"license_number": "PT.PT.60512345",
"holder": {
"full_name": "Jordan A Rivera",
"first_name": "Jordan",
"middle_name": "A",
"last_name": "Rivera",
"suffix": null
},
"status": {
"code": "active",
"name": "Active",
"native": "Active",
"is_active": true
},
"dates": {
"first_issued_on": "2019-06-14",
"last_renewed_on": "2025-05-02",
"expires_on": "2027-05-02"
},
"discipline": {
"has_public_action": false,
"actions": []
},
"location": {
"city": null,
"region": null,
"postal_code": null
},
"attributes": {
"ce_due_on": "2027-05-02"
},
"documents": [
{
"kind": "search_page",
"url": "https://wahelms.my.site.com/s/license-search",
"title": "WA DOH license search"
}
],
"provenance": {
"source_id": "wa-doh",
"authority": "Washington State Department of Health",
"verification_level": "primary_source",
"statement": "The department states this data is a primary source for verification of credentials.",
"source_url": "https://wahelms.my.site.com/s/license-search",
"observed_at": "2026-11-18T14:02:11.000Z",
"source_as_of": "2026-11-18T10:00:00.000Z",
"first_seen_at": "2026-11-18T14:02:11.000Z",
"last_changed_at": "2026-11-18T14:02:11.000Z",
"record_hash": "9f2c…"
}
},
"exclusion_check": {
"status": "no_match",
"match_method": null,
"source_as_of": "2026-10-31T00:00:00.000Z",
"matches": [],
"has_more_matches": false,
"sam_gov": {
"status": "no_match",
"match_method": null,
"source_as_of": "2026-11-18T00:00:00.000Z",
"matches": [],
"has_more_matches": false
}
},
"credits_charged": 1,
"failure_reason": null,
"created_at": "2026-11-18T14:05:00.000Z",
"completed_at": "2026-11-18T14:05:00.000Z"
}
],
"has_more": false,
"next_cursor": null
}Retrieve a verification
Retrieves a verification from the API key’s organization.
| Parameter | In | Description |
|---|---|---|
id | path |
curl https://www.alliedverify.com/v1/verifications/ver_2h6k9m1n4p7q0r3s5t8v1w4x6y \ -H "Authorization: Bearer $ALLIED_VERIFY_KEY"
Responses: 200 The verification. 404 Not found.
Example response
{
"object": "verification",
"id": "ver_2h6k9m1n4p7q0r3s5t8v1w4x6y",
"status": "completed",
"outcome": "found",
"reference": "candidate-1042",
"request": {
"jurisdiction": "WA",
"license_number": "PT60512345",
"credential_type": "pt"
},
"credential": {
"object": "credential",
"id": "cred_4k2m9q0d7f3h1j5n8p6r2t4v0w",
"jurisdiction": {
"code": "WA",
"name": "Washington"
},
"profession": {
"code": "physical_therapy",
"name": "Physical therapy"
},
"credential_type": {
"code": "pt",
"name": "Physical Therapist"
},
"credential_class": {
"code": "license",
"name": "License"
},
"native_type": "Physical Therapist License",
"license_number": "PT.PT.60512345",
"holder": {
"full_name": "Jordan A Rivera",
"first_name": "Jordan",
"middle_name": "A",
"last_name": "Rivera",
"suffix": null
},
"status": {
"code": "active",
"name": "Active",
"native": "Active",
"is_active": true
},
"dates": {
"first_issued_on": "2019-06-14",
"last_renewed_on": "2025-05-02",
"expires_on": "2027-05-02"
},
"discipline": {
"has_public_action": false,
"actions": []
},
"location": {
"city": null,
"region": null,
"postal_code": null
},
"attributes": {
"ce_due_on": "2027-05-02"
},
"documents": [
{
"kind": "search_page",
"url": "https://wahelms.my.site.com/s/license-search",
"title": "WA DOH license search"
}
],
"provenance": {
"source_id": "wa-doh",
"authority": "Washington State Department of Health",
"verification_level": "primary_source",
"statement": "The department states this data is a primary source for verification of credentials.",
"source_url": "https://wahelms.my.site.com/s/license-search",
"observed_at": "2026-11-18T14:02:11.000Z",
"source_as_of": "2026-11-18T10:00:00.000Z",
"first_seen_at": "2026-11-18T14:02:11.000Z",
"last_changed_at": "2026-11-18T14:02:11.000Z",
"record_hash": "9f2c…"
}
},
"exclusion_check": {
"status": "no_match",
"match_method": null,
"source_as_of": "2026-10-31T00:00:00.000Z",
"matches": [],
"has_more_matches": false,
"sam_gov": {
"status": "no_match",
"match_method": null,
"source_as_of": "2026-11-18T00:00:00.000Z",
"matches": [],
"has_more_matches": false
}
},
"credits_charged": 1,
"failure_reason": null,
"created_at": "2026-11-18T14:05:00.000Z",
"completed_at": "2026-11-18T14:05:00.000Z"
}Search
Free identity search across the records we hold.
Search credentials
Free, masked name search. The default matches name prefixes. Set fuzzy=true for scored search by normalized full last name, with optional first and middle names. Supplying middle_name, city, county or npi also enables scored search. Scored search ignores case, accents and hyphens, and can match common nicknames and middle initials. Verify a result with its credential_id. A license_number or status search parameter returns 400.
| Parameter | In | Description |
|---|---|---|
last_name | query | Last-name prefix by default. Full last name in scored search. Use at least two letters. |
first_name | query | First-name prefix by default. Full first name or nickname in scored search. |
middle_name | query | Middle name or initial. Requires first_name and enables scored search. |
fuzzy | query | Enable scored search. |
city | query | Normalized board-published city of record. Enables scored search. |
county | query | Board-published county of record, when available. The County suffix is optional. Enables scored search. |
npi | query | Subject’s NPI. Requires a board NPI or a current NPPES link to the license and issuing state. Enables scored search. |
jurisdiction | query | Two-letter state code. |
credential_type | query | Credential type code. One of: pt pta ot ota rt slp slpa aud auda at mrt nct ra pmrt mp perf sa rd dt dp hid po poa |
profession | query | Profession code. One of: physical_therapy occupational_therapy respiratory_care speech_language_pathology audiology athletic_training radiologic_technology medical_physics perfusion surgical_assisting dietetics dyslexia_therapy hearing_instrument_dispensing orthotics_and_prosthetics |
limit | query | 1–100. Default 25. Larger values return 100. Other values return 400. |
starting_after | query | Cursor from a previous page. A malformed cursor returns 400. |
curl https://www.alliedverify.com/v1/credentials?last_name=rivera&jurisdiction=WA&credential_type=pt \ -H "Authorization: Bearer $ALLIED_VERIFY_KEY"
Responses: 200 Matches in name order by default, or by descending match score with name order for ties. 400 Invalid search.
Coverage
What is covered, from where, and how fresh it is.
Coverage matrix
One row per jurisdiction, credential type and source. California uses monthly DCA rosters. Texas uses the Texas Medical Board roster and TDLR license files. Texas physical and occupational therapy credentials remain outside coverage. New York covers radiologic technologist registration from the weekly Department of Health roster. Verify NY radiologic technologists by license number. Illinois uses the IDFPR open-data roster, which can omit licenses, including occupational therapy licenses. Use full nine-digit Illinois license numbers. For Illinois radiologic technologists, the IEMA-OHS directory checks the exact accreditation number. Ohio imports the DataOhio eLicense roster with a public action indicator. The separate Ohio ODH radiologic roster lists the license category and omits status, dates and actions. New Jersey imports the dated DCA individual roster and its discipline indicator. Use the full New Jersey license number. New Jersey radiologic technology is verified separately through NJDEP. Michigan imports the LARA FOIA license lists daily. They include only current licenses, and a suspended or disciplinary limited status sets the public action flag. Use the full 10-digit Michigan license number.
curl https://www.alliedverify.com/v1/coverage
Responses: 200 Coverage rows.
List sources
Every source with its verification level, credential types and rights notes.
curl https://www.alliedverify.com/v1/sources
Responses: 200 Sources.
Retrieve a source
| Parameter | In | Description |
|---|---|---|
id | path |
curl https://www.alliedverify.com/v1/sources/wa-doh
Responses: 200 The source. 404 Not found.
Code catalog
Every profession, credential type, credential class and status code the API can return.
curl https://www.alliedverify.com/v1/catalog
Responses: 200 Catalog.
Account
Your credit balance and plan.
Retrieve your account
Returns the API key’s organization plan and credits. The email identifies the user who created the key.
curl https://www.alliedverify.com/v1/account \ -H "Authorization: Bearer $ALLIED_VERIFY_KEY"
Responses: 200 Plan and credits.