reports

Create Report

Issue a proof report: a PDF of a license's verdict, record and linked licenses as they stood at a moment.

The PDF is kept exactly as issued, and its SHA-256 is published at its verify_url, so anyone holding a copy can confirm it wasn't changed. Issuing one counts as a verification of the license (free if you already verified it today). Links are today's links, each license rebuilt as it stood at the moment.

Args: body: The license and the moment (default now). key: Injected: the caller's paid key. licenses: Injected LicenseRepository. history: Injected HistoryRepository, for the record as it stood. reports: Injected ReportRepository. keys: Injected ApiKeyRepository, to count the verification.

Returns: The issued report.

Raises: HTTPException: 404 when the license didn't exist then; 429 for too many reports; 503 if no code could be drawn. LicenseNotFoundError: For an unknown license (a 404).

post/reports

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/reports
  • Auth: none declared

Request body

license_idstring uuid required

The license to report on.

as_ofstring nullable

The moment to report as of: an ISO 8601 timestamp (no zone means UTC) or a date (its end, UTC). Omit for now. Our record of changes began 2026-10-04 05:51 UTC.

Response

Successful Response

idstring uuid required

The report's ID, for GET /reports/{id}.pdf.

codestring required

Its verification code; anyone can check it at verify_url.

license_idstring uuid required

The license it reports on.

contractor_namestring required

The licensee.

statestring required

The license's state.

license_numberstring required

The license number.

as_ofstring date-time required

The moment it reports on.

issued_atstring date-time required

When it was issued.

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

The overall verification verdict for a license.

sha256string required

The PDF's SHA-256: any changed copy won't match it.

verify_urlstring required

The public page that confirms the report is genuine.

Changes

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