Skip to content
Compliance & Registries

Complaint Check

Consumer complaint totals, top issues and 12-month trend for a financial company.

POST/v1/complaint-check
2 creditsBulk supportedUS
Request
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"}'
Response
{
  "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>required

Your 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.

companystringrequired

Company name. Example: Northwind Financial

freshboolean

Skip the 7-day cache and run a new lookup. Charged as a normal lookup.

referencestring

Your 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.

successboolean

true when the lookup ran.

data.matched_namestring

The company name as CFPB lists it, so you know which entity the numbers belong to.

data.total_complaintsnumber

All published complaints sent to the company.

data.last_12_months.complaintsnumber

Complaints received in the most recent 12 months.

data.last_12_months.change_pctnumber

Percent change against the 12 months before that.

data.top_productsarray

The financial products that draw the most complaints, with counts and share.

data.top_issuesarray

The issues consumers selected most often when they filed.

data.timely_response_ratenumber

The share of complaints the company answered on time, as recorded by CFPB.

meta.credits_usednumber

Credits charged for this call.

meta.credits_remainingnumber

Your balance after the call.

meta.cachedboolean

true when the result came from the 7-day cache.

meta.request_idstring

Quote 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.

HTTPCodeMeaning
401unauthorizedThe key is missing, malformed or revoked.
402insufficient_creditsYour credits are used up and pay as you go is off or at its limit.
422invalid_inputA field is missing or malformed. The field property names it.
429rate_limitedToo many requests for this key. Wait for the Retry-After interval.
500internal_errorSomething failed on our side. Safe to retry.
503source_unavailableAn 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