{"uid":"cap_takvvPwrjcGi-PQEZV2Io","slug":"license-record-lookup-by-number-ed443a4e","name":"License Record Lookup by Number","description":"Look up license record(s) by native license number, optionally scoped to a state.","url":"https://licenses.recordsforagents.com/licenses/by-number/:license_number","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["license_number"],"properties":{"license_number":{"type":"string"}}},"queryParams":{"type":"object","required":[],"properties":{"state":{"enum":["tx","fl","or","de","va"],"type":"string"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_r38d1-uIiewQvXWT--fFe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieve license record(s) from state contractor/trade license databases by providing a specific license number, with optional state scoping.","exampleAgentPrompt":"Can you pull up the license record for contractor license number M-45821 in Texas so I can verify their credentials?","exampleUseCases":null,"resultDescription":"Returns one or more license records matching the provided license number, including licensee name, license status, license type, expiration date, and issuing state. Results may be scoped to a specific state (tx, fl, or, ct) if provided.","failureModes":["License number not found — returns empty result set or 404","Invalid state code supplied — validation error","License number format mismatch for the given state — no results","Service unavailable or payment failure — 402 or 5xx error","Ambiguous license number matching multiple records across states without state scoping"],"whenToPreferThis":"Use this endpoint when you have a specific license number and need to retrieve the associated license record(s). Prefer this over the free-text search endpoint when the exact license number is known, as it returns precise matches rather than fuzzy search results. Use the optional state parameter when you know the issuing state to narrow results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:32:16.188Z","isFirstParty":false}