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.

POST/v1/batchesAPI key

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.

ParameterInDescription
rowsbody
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.

GET/v1/batches/{id}API key

Retrieve batch results

Poll every 10 seconds while the batch is processing. Returns all rows in submission order. Completed and stopped batches are terminal.

ParameterInDescription
idpath
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.

POST/v1/verificationsAPI key

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.

ParameterInDescription
credential_idbodyCredential id from GET /v1/credentials.
jurisdictionbodyTwo-letter state code.
license_numberbodyLicense number. For North Carolina, Ohio and Pennsylvania, send the full number with its letters and leading zeros. Other sources may match by digits.
first_namebodyFirst name for a name verification. Supports common nicknames and can include a middle name or initial.
middle_namebodyOptional middle name or initial for a name verification.
last_namebodyFull last name for a name verification. Ignores case, accents, spaces and punctuation.
citybodyFilter by normalized board-published city when verifying by name or license number.
countybodyFilter by board-published county where available. The County suffix is optional.
credential_typebodyNarrow 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
npibodyOptional 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.
referencebodyYour 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"
}
GET/v1/verificationsAPI key

List verifications

Lists verification history for the API key’s organization.

ParameterInDescription
qquerySubstring of the saved holder name or the saved or requested license number. Ignores case for A–Z.
jurisdictionqueryTwo-letter issuing state code.
statusqueryVerification processing status.
One of: pending completed failed
outcomequeryVerification result.
One of: found not_found
credential_statusqueryLicense status in the saved report.
One of: active active_restricted probation inactive expired suspended revoked surrendered pending denied unknown
referencequeryExact, case-sensitive customer reference.
fromqueryFirst creation date to include (UTC).
toqueryLast creation date to include (UTC).
sortqueryOrder by creation date. Default newest.
One of: newest oldest
limitquery1–100. Default 25. Larger values return 100. Other values return 400.
starting_afterqueryCursor 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
}
GET/v1/verifications/{id}API key

Retrieve a verification

Retrieves a verification from the API key’s organization.

ParameterInDescription
idpath
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.

GET/v1/credentialsAPI key

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.

ParameterInDescription
last_namequeryLast-name prefix by default. Full last name in scored search. Use at least two letters.
first_namequeryFirst-name prefix by default. Full first name or nickname in scored search.
middle_namequeryMiddle name or initial. Requires first_name and enables scored search.
fuzzyqueryEnable scored search.
cityqueryNormalized board-published city of record. Enables scored search.
countyqueryBoard-published county of record, when available. The County suffix is optional. Enables scored search.
npiquerySubject’s NPI. Requires a board NPI or a current NPPES link to the license and issuing state. Enables scored search.
jurisdictionqueryTwo-letter state code.
credential_typequeryCredential 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
professionqueryProfession 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
limitquery1–100. Default 25. Larger values return 100. Other values return 400.
starting_afterqueryCursor 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.

GET/v1/coveragePublic

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.

GET/v1/sourcesPublic

List sources

Every source with its verification level, credential types and rights notes.

curl https://www.alliedverify.com/v1/sources

Responses: 200 Sources.

GET/v1/sources/{id}Public

Retrieve a source

ParameterInDescription
idpath
curl https://www.alliedverify.com/v1/sources/wa-doh

Responses: 200 The source. 404 Not found.

GET/v1/catalogPublic

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.

GET/v1/accountAPI key

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.