licenses

Get Verdict

Verify a license: Clear, Review, or Risk found, with every check behind it, now or as of a past moment.

Weighs the license's own status, expiry and bond, every license linked to the same contractor, and any adverse unconfirmed possible match -- the same verdict the website shows, so API customers never have to re-derive it from /graph. With as_of, it's the verdict as the record stood then ("was this license good on the day we funded?"), rebuilt from the changes recorded since, with what that rests on in as_of.

Args: license_id: The license's internal UUID. as_of: A past moment to verify the license as of, or None for now. repo: Injected LicenseRepository. history: Injected HistoryRepository.

Returns: The verdict, its one-sentence summary, and each check.

Raises: LicenseNotFoundError: If no license with that id exists (a 404). HTTPException: 422 for an as_of that isn't a date or time, is in the future, or is before our record began; 404 if the license first appeared after as_of.

get/licenses/{license_id}/verdict

Request

  • Base URL: https://api.licenscheck.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.licenscheck.com/licenses/{license_id}/verdict
  • Auth: none declared

Path parameters

license_idstring uuid required

Query parameters

as_ofstring nullable

Verify the license as it stood at a past moment instead of now: a date (YYYY-MM-DD, meaning the end of that day, UTC) or an ISO 8601 timestamp. Our record of changes began on 2026-10-04.

Example:2026-10-04

Response

Successful Response

license_idstring uuid required

ID of the license that was verified.

level'clear' | 'review' | 'risk' required

The overall verification verdict for a license.

wordstring required

The level as shown to a reader: "Clear", "Review", or "Risk found".

summarystring required

One plain-English sentence explaining the level.

Changes

No recorded changes to this operation across all 1 revision of this API.