Check Compliance

Evaluate contractor against compliance rules (active license, workers comp, surety bond, citations). Returns instant deterministic boolean (can_hire), risk score, and risk flags.

post/v1/compliance-check

Request

  • Base URL: https://licenseground.com (the document declares no server; this is the origin it was published from)
  • URL: https://licenseground.com/v1/compliance-check
  • Auth: none declared

Headers

X-Agent-Keystring nullable
X-Agent-API-Keystring nullable

Request body

entity_namestring nullable
license_numberstring nullable
state'CA' | 'FL' | 'TX' | 'NY' | 'MA' | 'IL' | 'AZ' | 'US' required
trade'roofing' | 'hvac' | 'electrical' | 'plumbing' | 'general_contractor' | 'any'
require_active_statusboolean

Enforce ACTIVE_CURRENT status.

require_workers_compboolean

Reject if no verified workers comp policy (or unverified exemption).

require_surety_bondboolean

Enforce active contractor bond.

max_disciplinary_actionsinteger

Maximum acceptable disciplinary citations.

min_confidence_scorenumber

Minimum entity name grounding match confidence.

Response

Successful Response

can_hireboolean required

Deterministic decision: True if compliant with all risk criteria.

risk_level'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL' required
risk_scorenumber required

Risk index from 0.0 (safest) to 100.0 (maximum risk).

flagsstring[]

Specific risk warning triggers.

Changes

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