Complaint Check
Consumer complaint totals, top issues and 12-month trend for a financial company.
curl -X POST https://api.1lookup.dev/v1/complaint-check \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"company":"Northwind Financial"}'{
"success": true,
"data": {
"company": "Northwind Financial",
"matched_name": "NORTHWIND FINANCIAL, INC.",
"total_complaints": 1284,
"first_complaint_date": "2016-03-09",
"latest_complaint_date": "2026-11-02",
"last_12_months": {
"complaints": 312,
"prior_12_months": 288,
"change_pct": 8.3,
"direction": "up"
},
"top_products": [
{
"product": "Credit card",
"complaints": 498,
"share": 0.39
},
{
"product": "Checking or savings account",
"complaints": 341,
"share": 0.27
},
{
"product": "Mortgage",
"complaints": 207,
"share": 0.16
}
],
"top_issues": [
{
"issue": "Problem with a purchase shown on your statement",
"complaints": 164
},
{
"issue": "Managing an account",
"complaints": 151
}
],
"timely_response_rate": 0.97
},
"meta": {
"credits_used": 2,
"credits_remaining": 999,
"cached": false,
"request_id": "req_8f3a2c1e9b7d"
}
}Authorization
Authorizationstring<bearer>requiredYour API key as a Bearer token. Live keys start with 1lk_live_. Test keys start with 1lk_test_ and return this endpoint's sample response without spending credits. See authentication.
Body
Send the fields as a JSON object with Content-Type: application/json.
companystringrequiredCompany name. Example: Northwind Financial
freshbooleanSkip the 7-day cache and run a new lookup. Charged as a normal lookup.
referencestringYour own identifier, echoed back in meta and shown in lookup history.
Response
A 200 response carries the result in data and the cost of the call in meta. These are the fields most integrations read.
successbooleantrue when the lookup ran.
data.matched_namestringThe company name as CFPB lists it, so you know which entity the numbers belong to.
data.total_complaintsnumberAll published complaints sent to the company.
data.last_12_months.complaintsnumberComplaints received in the most recent 12 months.
data.last_12_months.change_pctnumberPercent change against the 12 months before that.
data.top_productsarrayThe financial products that draw the most complaints, with counts and share.
data.top_issuesarrayThe issues consumers selected most often when they filed.
data.timely_response_ratenumberThe share of complaints the company answered on time, as recorded by CFPB.
meta.credits_usednumberCredits charged for this call.
meta.credits_remainingnumberYour balance after the call.
meta.cachedbooleantrue when the result came from the 7-day cache.
meta.request_idstringQuote this when you contact support.
Errors
A failed request returns success: false with an error object, and is never charged. The full list is on the errors page.
| HTTP | Code | Meaning |
|---|---|---|
| 401 | unauthorized | The key is missing, malformed or revoked. |
| 402 | insufficient_credits | Your credits are used up and pay as you go is off or at its limit. |
| 422 | invalid_input | A field is missing or malformed. The field property names it. |
| 429 | rate_limited | Too many requests for this key. Wait for the Retry-After interval. |
| 500 | internal_error | Something failed on our side. Safe to retry. |
| 503 | source_unavailable | An upstream source did not answer in time. Safe to retry. |
Billing
2 credits. Charged when the lookup runs and returns a result. Errors are never charged, and repeating the same input within 7 days is served from cache at no charge.
Product overview and use cases