PULLFIRST[THE RECORD]
API ReferenceAg Enforcement

Get AG enforcement actions matched to a specific license number

GET
/v1/ag-enforcement/by-license/{licenseNumber}

Returns Minnesota AG consumer-protection actions matched to this license number via fuzzy name matching (AG records rarely carry a license number natively). Each record carries a tier: VERIFIED (name plus geographic corroboration), LIKELY (unambiguous name match), POSSIBLE (weaker fuzzy score), AMBIGUOUS (name collides with multiple licensees — cannot be uniquely attributed). Callers must handle AMBIGUOUS.

AuthorizationBearer <token>

API key passed as a Bearer token. Keys start with sk_live_.

In: header

Path Parameters

licenseNumber*string

The license number (e.g., BC808194)

Length0 <= length <= 50

Response Body

application/json

curl -X GET "https://loading/api/docs-proxy/v1/ag-enforcement/by-license/string"
[
  {
    "id": 0,
    "companyName": "string",
    "dbaNames": [
      "string"
    ],
    "individualNames": [
      "string"
    ],
    "city": "string",
    "state": "string",
    "orderType": "string",
    "actionsTaken": [
      "string"
    ],
    "penaltyAmount": 0,
    "stayedAmount": 0,
    "orderDate": "2019-08-24",
    "violationTypes": [
      "string"
    ],
    "title": "string",
    "lede": "string",
    "sourceUrl": "string",
    "matchedLicenses": [
      "string"
    ],
    "contractorMatches": [
      {
        "id": 0,
        "licenseNumber": "string",
        "licenseName": "string",
        "matchScore": 0,
        "matchMethod": "string",
        "matchConfidence": "string",
        "isVerified": true,
        "tier": "string",
        "verificationSignals": "string",
        "candidateCount": 0
      }
    ]
  }
]