curl -X POST https://win.oneshotagent.com/v1/tools/lookup/company-contractor-license \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"state": "WA",
"license_number": "ABSHEC*345PS"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/company-contractor-license", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"state": "WA",
"license_number": "ABSHEC*345PS"
}),
});
const result = await agent.tool('lookup/company-contractor-license', {
state: 'WA',
license_number: 'ABSHEC*345PS'
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "company_contractor_license",
"result": {
"state": "WA",
"licenses": [
{
"license_number": "ABSHEC*345PS",
"business_name": "ABSHER CONSTRUCTION CO",
"license_type": "CONSTRUCTION CONTRACTOR",
"status": "ACTIVE",
"active": true,
"effective_on": "1966-10-10",
"expires_on": "2027-01-08",
"suspended_on": null,
"business_type": "Corporation",
"specialties": [
"GENERAL"
],
"ubi": "275003716",
"principal_name": "ABSHER, THOMAS LOWELL",
"address": {
"street": "1001 Shaw Rd",
"city": "Puyallup",
"state": "WA",
"postal_code": "98372"
}
}
]
},
"evidence": {
"source": "Washington State Department of Labor & Industries",
"source_kind": "public",
"retrieved_at": "2026-10-20T22:53:37.000Z",
"calls": [
{
"retrieved_at": "2026-10-20T22:53:37.000Z"
}
],
"as_of": null
}
}
}
Government & legal
Contractor Licence
Look up Washington State contractor licences by licence number, state business identifier or business name, with status, type, specialties and expiration dates.
POST
/
v1
/
tools
/
lookup
/
company-contractor-license
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/company-contractor-license \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"state": "WA",
"license_number": "ABSHEC*345PS"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/company-contractor-license", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"state": "WA",
"license_number": "ABSHEC*345PS"
}),
});
const result = await agent.tool('lookup/company-contractor-license', {
state: 'WA',
license_number: 'ABSHEC*345PS'
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "company_contractor_license",
"result": {
"state": "WA",
"licenses": [
{
"license_number": "ABSHEC*345PS",
"business_name": "ABSHER CONSTRUCTION CO",
"license_type": "CONSTRUCTION CONTRACTOR",
"status": "ACTIVE",
"active": true,
"effective_on": "1966-10-10",
"expires_on": "2027-01-08",
"suspended_on": null,
"business_type": "Corporation",
"specialties": [
"GENERAL"
],
"ubi": "275003716",
"principal_name": "ABSHER, THOMAS LOWELL",
"address": {
"street": "1001 Shaw Rd",
"city": "Puyallup",
"state": "WA",
"postal_code": "98372"
}
}
]
},
"evidence": {
"source": "Washington State Department of Labor & Industries",
"source_kind": "public",
"retrieved_at": "2026-10-20T22:53:37.000Z",
"calls": [
{
"retrieved_at": "2026-10-20T22:53:37.000Z"
}
],
"as_of": null
}
}
}
Look up a construction contractor in the Washington State contractor licence register, which refreshes daily.
state is required; currently only WA is covered. Give exactly one of license_number, ubi (the state business identifier) and name. Names are matched ignoring case as a substring of the business name, so a short distinctive fragment works best. Return at most limit licences, newest effective date first, each with its type, status, whether it is active, effective, expiration and suspension dates, specialties, business type, principal and address. The phone number is not returned, and the street line is null for an individual (a sole proprietor), whose street may be a home. Missing values are null; dates are YYYY-MM-DD. An empty licenses list is a completed result: no licence was found under that number, identifier or name, not evidence that the contractor never held one.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
required
State whose contractor register is searched. One of
WA.string
The state contractor licence number, including any asterisks. 1 to 20 characters.
string
The state business identifier (UBI).
string
A fragment of the business name, matched ignoring case. 2 to 100 characters.
integer
Most licences to return. From 1 to 20. Defaults to
5.Response (200 OK)
Top-level envelope:success (boolean) and data (object). All fields below are nested under data.
string
Durable job ID for audit and lookup
string
Job status:
completedstring
Always
company_contractor_licenseobject
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always
Washington State Department of Labor & Industries.string
public when the data comes from a public body, commercial otherwisestring
When the lookup was made, as an ISO 8601 UTC time
string
When the source says the fact was last updated, or
null when the source gives no dateResult
Nested underdata.result.
string
The state asked for.
object[]
Matching licences, newest effective date first; empty when none matched.
string
The state contractor licence number.
string
The business name on the licence.
null when the source gives no value.string
The licence type in the state’s words, for example CONSTRUCTION CONTRACTOR.
null when the source gives no value.string
The licence status in the state’s words, for example ACTIVE or RE-LICENSED.
null when the source gives no value.boolean
Whether the state marks the licence active.
string
Licence effective date, YYYY-MM-DD or null.
string
Licence expiration date, YYYY-MM-DD or null.
string
Licence suspension date, YYYY-MM-DD, or null when not suspended.
string
The business structure, for example Corporation or Individual.
null when the source gives no value.string[]
The licensed specialties, for example GENERAL or HVAC/RFRG; empty when none are stated.
string
The state business identifier, for joining with other state records.
null when the source gives no value.string
The primary principal named on the licence.
null when the source gives no value.object
The address on the licence; the phone number is not returned.
string
Street line, or null for an individual (sole proprietor), whose street may be a home.
string
City.
null when the source gives no value.string
State.
null when the source gives no value.string
ZIP code.
null when the source gives no value.curl -X POST https://win.oneshotagent.com/v1/tools/lookup/company-contractor-license \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"state": "WA",
"license_number": "ABSHEC*345PS"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/company-contractor-license", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"state": "WA",
"license_number": "ABSHEC*345PS"
}),
});
const result = await agent.tool('lookup/company-contractor-license', {
state: 'WA',
license_number: 'ABSHEC*345PS'
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "company_contractor_license",
"result": {
"state": "WA",
"licenses": [
{
"license_number": "ABSHEC*345PS",
"business_name": "ABSHER CONSTRUCTION CO",
"license_type": "CONSTRUCTION CONTRACTOR",
"status": "ACTIVE",
"active": true,
"effective_on": "1966-10-10",
"expires_on": "2027-01-08",
"suspended_on": null,
"business_type": "Corporation",
"specialties": [
"GENERAL"
],
"ubi": "275003716",
"principal_name": "ABSHER, THOMAS LOWELL",
"address": {
"street": "1001 Shaw Rd",
"city": "Puyallup",
"state": "WA",
"postal_code": "98372"
}
}
]
},
"evidence": {
"source": "Washington State Department of Labor & Industries",
"source_kind": "public",
"retrieved_at": "2026-10-20T22:53:37.000Z",
"calls": [
{
"retrieved_at": "2026-10-20T22:53:37.000Z"
}
],
"as_of": null
}
}
}
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers
200.Notes
- Results return inline. The finished job stays available at
/v1/requests/{request_id}