curl -X POST https://win.oneshotagent.com/v1/tools/lookup/company-consumer-complaints \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"company_name": "Wells Fargo",
"limit": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/company-consumer-complaints", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"company_name": "Wells Fargo",
"limit": 1
}),
});
const result = await agent.tool('lookup/company-consumer-complaints', {
company_name: 'Wells Fargo',
limit: 1
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "company_consumer_complaints",
"result": {
"total": 176252,
"companies": [
{
"name": "WELLS FARGO & COMPANY",
"count": 176252
}
],
"by_product": [
{
"name": "Mortgage",
"count": 49852
}
],
"by_response": [
{
"name": "Closed with explanation",
"count": 139770
}
],
"complaints": [
{
"id": "29372201",
"company": "WELLS FARGO & COMPANY",
"product": "Credit reporting or other personal consumer reports",
"sub_product": "Other personal consumer report",
"issue": "Identity theft protection or other monitoring services",
"sub_issue": "Problem canceling credit monitoring or identify theft protection service",
"state": "CA",
"received_on": "2026-10-07",
"response": "Closed with explanation",
"public_response": "Company has responded to the consumer and the CFPB and chooses not to provide a public response",
"timely": true
}
]
},
"evidence": {
"source": "US Consumer Financial Protection Bureau",
"source_kind": "public",
"retrieved_at": "2026-10-13T12:00:00.000Z",
"as_of": null
}
}
}
Lookups
Consumer Finance Complaints
Count the consumer complaints filed about a financial company, with what they are about, how the company answered and the newest ones.
POST
/
v1
/
tools
/
lookup
/
company-consumer-complaints
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/company-consumer-complaints \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"company_name": "Wells Fargo",
"limit": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/company-consumer-complaints", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"company_name": "Wells Fargo",
"limit": 1
}),
});
const result = await agent.tool('lookup/company-consumer-complaints', {
company_name: 'Wells Fargo',
limit: 1
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "company_consumer_complaints",
"result": {
"total": 176252,
"companies": [
{
"name": "WELLS FARGO & COMPANY",
"count": 176252
}
],
"by_product": [
{
"name": "Mortgage",
"count": 49852
}
],
"by_response": [
{
"name": "Closed with explanation",
"count": 139770
}
],
"complaints": [
{
"id": "29372201",
"company": "WELLS FARGO & COMPANY",
"product": "Credit reporting or other personal consumer reports",
"sub_product": "Other personal consumer report",
"issue": "Identity theft protection or other monitoring services",
"sub_issue": "Problem canceling credit monitoring or identify theft protection service",
"state": "CA",
"received_on": "2026-10-07",
"response": "Closed with explanation",
"public_response": "Company has responded to the consumer and the CFPB and chooses not to provide a public response",
"timely": true
}
]
},
"evidence": {
"source": "US Consumer Financial Protection Bureau",
"source_kind": "public",
"retrieved_at": "2026-10-13T12:00:00.000Z",
"as_of": null
}
}
}
Given a financial company’s name, return how many complaints consumers have filed about it with the US Consumer Financial Protection Bureau, the five largest groups by product and by how the company answered, and the newest complaints. Use it to check a bank, lender, card issuer or credit bureau before dealing with it. Complaints are consumers’ reports, not findings. The source matches the name as text, so similarly named companies can appear:
companies lists the five most matched names with their counts and every complaint carries the company name the source holds. since (YYYY-MM-DD) counts only complaints received on or after that date and limit sets how many complaints are returned (1 to 25, default 10). A name with no complaint is a completed result with a total of 0 and empty lists.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
required
The financial company’s name, 2 to 100 characters, for example Wells Fargo. 2 to 100 characters.
string
Count only complaints received on or after this date, YYYY-MM-DD; default all. Use YYYY-MM-DD.
integer
Most complaints to return, newest first, 1 to 25; default 10. From 1 to 25. Defaults to
10.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_consumer_complaintsobject
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always
US Consumer Financial Protection Bureau.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.
number
Complaints matching the name (and
since, when given).object[]
The five most matched company names, so the caller can see whether the name was ambiguous.
string
The company name as the source holds it.
number
Count.
object[]
The five largest groups by financial product.
string
Name.
number
Count.
object[]
The five largest groups by how the company answered.
string
Name.
number
Count.
object[]
The newest complaints first.
string
The source’s complaint id.
null when the source gives no value.string
The company name as the source holds it.
null when the source gives no value.string
Product.
null when the source gives no value.string
Sub product.
null when the source gives no value.string
Issue.
null when the source gives no value.string
Sub issue.
null when the source gives no value.string
US state of the consumer.
null when the source gives no value.string
Date the source received the complaint, YYYY-MM-DD.
null when the source gives no value.string
How the company answered, for example Closed with explanation.
null when the source gives no value.string
The company’s public statement, when it gave one.
null when the source gives no value.boolean
True when the company answered within the time allowed.
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/company-consumer-complaints \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"company_name": "Wells Fargo",
"limit": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/company-consumer-complaints", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"company_name": "Wells Fargo",
"limit": 1
}),
});
const result = await agent.tool('lookup/company-consumer-complaints', {
company_name: 'Wells Fargo',
limit: 1
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "company_consumer_complaints",
"result": {
"total": 176252,
"companies": [
{
"name": "WELLS FARGO & COMPANY",
"count": 176252
}
],
"by_product": [
{
"name": "Mortgage",
"count": 49852
}
],
"by_response": [
{
"name": "Closed with explanation",
"count": 139770
}
],
"complaints": [
{
"id": "29372201",
"company": "WELLS FARGO & COMPANY",
"product": "Credit reporting or other personal consumer reports",
"sub_product": "Other personal consumer report",
"issue": "Identity theft protection or other monitoring services",
"sub_issue": "Problem canceling credit monitoring or identify theft protection service",
"state": "CA",
"received_on": "2026-10-07",
"response": "Closed with explanation",
"public_response": "Company has responded to the consumer and the CFPB and chooses not to provide a public response",
"timely": true
}
]
},
"evidence": {
"source": "US Consumer Financial Protection Bureau",
"source_kind": "public",
"retrieved_at": "2026-10-13T12:00:00.000Z",
"as_of": null
}
}
}
Price: $0.005 per lookup. See Pricing for every tool.
Notes
- Results return inline. The finished job stays available at
/v1/requests/{request_id}