Licenses

Get license for a specific state

Returns a single license record for a US state. A state can hold more than one license (different activity types, or state-level plus city-level entries); when that happens this endpoint returns the most recently updated one and reports the count in meta.total — use GET /licenses?state=XX to retrieve all of them. State codes are case-insensitive.

get/licenses/{state}

Request

  • Base URL
    https://app.payna.com/api/v1
  • URL
    https://app.payna.com/api/v1/licenses/{state}
  • Auth
    HTTP bearer

Path parameters

statestring required

2-letter US state code. Example: CA

Response

License found.

Example response

{
  "data": {
    "state_code": "CA",
    "license_type": "California - DFPI Debt Collection License",
    "activity_type": "debt_collection",
    "license_number": "CCA-2671499",
    "nmls_id": "2671499",
    "regulator": "DFPI",
    "sub_status": "withdrawn",
    "raw_status": "Approved-Active",
    "issued_date": "2023-06-15",
    "renewal_date": "2026-12-31",
    "days_until_renewal": 168,
    "jurisdiction_level": "state",
    "filing_method": "nmls",
    "status_detail": {
      "code": "voluntary_withdrawal",
      "label": "Withdrawn — voluntary",
      "portal": {
        "name": "Delaware One Stop",
        "url": "https://onestop.delaware.gov/Account_SignIn"
      },
      "source_text": "Withdrawn - Voluntary Without Licensure"
    }
  },
  "meta": {
    "total": 1
  }
}

Changes

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