# OneShot Agent API – Company Consumer Complaints Lookup

> OneShot Agent API – Company Consumer Complaints Lookup is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-19).

Retrieves CFPB consumer complaint data for a named financial company, including complaint counts, breakdowns by product and response type, and individual complaint records.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/lookup/company-consumer-complaints?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-api-company-consumer-complaints-lookup-ee4fd3e0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_T_9v4nZMiXLRJYSh_5djG

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability oneshot-agent-api-company-consumer-complaints-lookup-ee4fd3e0 -d '<json body>'
```

Example prompt: Pull up the CFPB consumer complaint records for Wells Fargo — show me the 15 most recent ones and break them down by product and response type.

## When to prefer this

Use this endpoint when you need structured, official CFPB regulatory complaint data for a specific financial institution — ideal for due diligence, competitive analysis, or assessing a company's complaint handling track record. Prefer this over general web search when you need quantitative, filterable complaint data with product and response breakdowns rather than anecdotal reviews.

## Known failure modes

- Company name not found or too ambiguous — returns empty complaints array
- Rate limiting or payment failure via x402 protocol
- Invalid date format for 'since' parameter — expects YYYY-MM-DD
- Limit out of range (must be 1–25) — validation error
- Company name under 2 or over 100 characters — schema validation failure

## How this service works

Count the consumer complaints filed about a financial company, with what they are about, how the company answered and the newest ones.

## Output

Returns a JSON object with the total complaint count for the matched company, a list of matching company name variants, complaint counts broken down by product and by company response type, and up to 25 individual complaint records each including issue, sub-issue, product, state, date received, company response, and whether the response was timely.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "Most complaints to return, newest first. From 1 to 25. Defaults to `10`."
  },
  "since": {
   "type": "string",
   "description": "Count only complaints received on or after this date. Use YYYY-MM-DD."
  },
  "company_name": {
   "type": "string",
   "description": "The financial company's name, for example Wells Fargo. 2 to 100 characters."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total": 176252,
  "companies": [
   {
    "name": "WELLS FARGO & COMPANY",
    "count": 176252
   }
  ],
  "by_product": [
   {
    "name": "Mortgage",
    "count": 49852
   }
  ],
  "complaints": [
   {
    "id": "29372201",
    "issue": "Identity theft protection or other monitoring services",
    "state": "CA",
    "timely": true,
    "company": "WELLS FARGO & COMPANY",
    "product": "Credit reporting or other personal consumer reports",
    "response": "Closed with explanation",
    "sub_issue": "Problem canceling credit monitoring or identify theft protection service",
    "received_on": "2026-10-07",
    "sub_product": "Other personal consumer report",
    "public_response": "Company has responded to the consumer and the CFPB and chooses not to provide a public response"
   }
  ],
  "by_response": [
   {
    "name": "Closed with explanation",
    "count": 139770
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-api-company-consumer-complaints-lookup-ee4fd3e0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)