# CFPB Consumer Complaints

> Search the US Consumer Financial Protection Bureau's public database of consumer complaints about banks, lenders, credit bureaus, debt collectors and other financial companies: find complaints by company, product, issue, state or date, read one, count them by any of these, and run a workflow when new ones are published. No account or API key required.

App · 6 actions. Web page: https://docs.lodol.com/docs/integrations/cfpb-complaints

## Actions

### Count complaints

Count the complaints that match your filters, grouped by product, issue, company, state, company response or another field, the largest group first, with each group's share. Use it for the complaints per state, the most complained about companies or a company's most common problems.

**Inputs**

- Group by (`group_by`, text): What to count the complaints by. Defaults to product. One of: `product`, `sub_product` (Sub-product), `issue`, `sub_issue` (Sub-issue), `company`, `state`, `company_response` (Company response), `company_public_response` (Company's public response), `submitted_via` (How it was submitted), `timely` (Answered on time), `tags`. Default: `product`.
- Search text (`search_term`, text): Words to look for in the complaint's company, product, issue and other details, e.g. overdraft. AND, OR and NOT work, and quotes find an exact phrase. Leave blank for every complaint.
- Look for the text in (`search_field`, text): Where to look for the search text. Defaults to every field. One of: `all` (Every field), `company` (Company names only). Default: `all`.
- Companies (`company`, list): Only complaints about these companies, named as the CFPB files them, e.g. WELLS FARGO & COMPANY. Pick from the list, or type a name: one that matches nothing is looked up and corrected. Leave blank for every company.
- Products (`product`, list): Only complaints about these products, or a product's sub-product, e.g. Mortgage or Mortgage > FHA mortgage. Leave blank for every product.
- Issues (`issue`, list): Only complaints about these problems, or a problem's sub-issue, e.g. Struggling to pay mortgage. Leave blank for every issue.
- States (`state`, list): Only complaints from consumers in these states or territories. Leave blank for everywhere. One or more of: `AL` (Alabama (AL)), `AK` (Alaska (AK)), `AS` (American Samoa (AS)), `AZ` (Arizona (AZ)), `AR` (Arkansas (AR)), `AA` (Armed Forces Americas (AA)), `AE` (Armed Forces Europe (AE)), `AP` (Armed Forces Pacific (AP)), `CA` (California (CA)), `CO` (Colorado (CO)), and 49 more.
- ZIP codes (`zip_code`, list): Only complaints from these 5-digit ZIP codes, as a list or separated by commas. For privacy the CFPB shortens some to 3 digits, e.g. 941XX.
- Received on or after (`date_received_from`, date): Only complaints the CFPB received on or after this day.
- Received on or before (`date_received_to`, date): Only complaints the CFPB received on or before this day.
- Company responses (`company_response`, list): Only complaints the company answered in one of these ways. One or more of: `Closed with explanation`, `Closed with non-monetary relief`, `Closed with monetary relief`, `Closed without relief`, `Closed with relief`, `Closed`, `In progress`, `Untimely response`.
- Answered on time (`timely`, text): Only complaints the company answered within 15 days, or only those it didn't. Leave blank for both. One of: `Yes` (On time), `No` (Late).
- Submitted by (`submitted_via`, list): Only complaints sent to the CFPB in one of these ways. One or more of: `Web`, `Referral`, `Phone`, `Postal mail`, `Fax`, `Email`.
- Tags (`tags`, list): Only complaints from older Americans (62 or over) or servicemembers, veterans and their families. A complaint can carry both. One or more of: `Older American`, `Servicemember`.
- Leave out products (`exclude_product`, list): Leave out complaints about these products, e.g. Credit reporting or other personal consumer reports, which make up most complaints.
- Most groups (`limit`, number): The most groups to list, largest first, from 1 to 1000. Defaults to 25. From 1 to 1000. Default: `25`.

**Outputs**

- `companies_searched` (list): The companies searched for, spelled the way the CFPB files them. A typed name that matched nothing is looked up and corrected here.
- `count` (number): How many groups are listed, at most the limit asked for.
- `group_by` (text): What the complaints were grouped by, e.g. 'product'.
- `groups` (list): The groups, the largest first.
- `summary` (text): One line with the total and the largest group.
- `total` (number): How many complaints match.
- `total_groups` (number): How many groups the matching complaints fall into.

**Example output**

```json
{
  "companies_searched": [
    "WELLS FARGO & COMPANY"
  ],
  "count": 3,
  "group_by": "product",
  "groups": [
    {
      "count": 384,
      "filter_value": "Checking or savings account",
      "parent": null,
      "percent": 47.29,
      "value": "Checking or savings account"
    },
    {
      "count": 122,
      "filter_value": "Money transfer, virtual currency, or money service",
      "parent": null,
      "percent": 15.02,
      "value": "Money transfer, virtual currency, or money service"
    },
    {
      "count": 115,
      "filter_value": "Credit card",
      "parent": null,
      "percent": 14.16,
      "value": "Credit card"
    }
  ],
  "summary": "812 complaints across 11 products; the most are Checking or savings account (384, 47.29%).",
  "total": 812,
  "total_groups": 11
}
```

### Get complaint

Get one published consumer complaint by its number: the company, product, issue, the company's response, whether it was on time, the state and ZIP code, and its page on consumerfinance.gov.

**Inputs**

- Complaint number (`complaint_id`, text, required): The complaint's number, e.g. 12749227, or the address of its page on consumerfinance.gov.

**Outputs**

- `company` (text): The company it is about, as the CFPB names it.
- `company_public_response` (text): The statement the company chose to publish about it, if any.
- `company_response` (text): How the company answered, e.g. 'Closed with explanation' or 'In progress'.
- `complaint_id` (text): The CFPB's number for the complaint, e.g. '12749227'.
- `date_received` (text): The day the CFPB received it (YYYY-MM-DD, UTC).
- `date_sent_to_company` (text): The day the CFPB sent it to the company (YYYY-MM-DD, UTC).
- `issue` (text): The problem the consumer named, e.g. 'Problem with a purchase'.
- `last_loaded_at` (text): When the CFPB last loaded this complaint into its public database (ISO 8601, UTC).
- `product` (text): The product the consumer named, e.g. 'Credit card'.
- `received_at` (text): When the CFPB received it (ISO 8601, UTC).
- `state` (text): The two-letter code of the consumer's state, e.g. 'CA'.
- `sub_issue` (text): The problem in more detail, when the consumer gave it.
- `sub_product` (text): The kind of product, e.g. 'General-purpose credit card'.
- `submitted_via` (text): How it was sent to the CFPB, e.g. 'Web' or 'Phone'.
- `summary` (text): One line about the complaint: who it is about, when and where it came from, the product and issue, and the company's response.
- `tags` (list): 'Older American' (62 or over) and 'Servicemember' when they apply.
- `timely_response` (true/false): True when the company answered within 15 days.
- `url` (text): The complaint's page on consumerfinance.gov.
- `zip_code` (text): The consumer's ZIP code. For privacy some show only their first 3 digits, e.g. '941XX'.

**Example output**

```json
{
  "company": "WELLS FARGO & COMPANY",
  "company_public_response": "Company has responded to the consumer and the CFPB and chooses not to provide a public response",
  "company_response": "Closed with non-monetary relief",
  "complaint_id": "12749227",
  "date_received": "2025-03-31",
  "date_sent_to_company": "2025-03-31",
  "issue": "Improper use of your report",
  "last_loaded_at": "2026-09-28T17:33:58Z",
  "product": "Credit reporting or other personal consumer reports",
  "received_at": "2025-03-31T18:49:39Z",
  "state": "CA",
  "sub_issue": "Reporting company used your report improperly",
  "sub_product": "Credit reporting",
  "submitted_via": "Web",
  "summary": "Complaint 12749227 about WELLS FARGO & COMPANY, received 2025-03-31 from CA (Credit reporting or other personal consumer reports: Improper use of your report). Company response: Closed with non-monetary relief.",
  "tags": [],
  "timely_response": true,
  "url": "https://www.consumerfinance.gov/data-research/consumer-complaints/search/detail/12749227",
  "zip_code": "92025"
}
```

### Get database status

Check how many complaints the CFPB has published, the day the newest was received, when it last loaded a batch, and whether it reports its data as stale or broken.

**Inputs**: None.

**Outputs**

- `has_data_issue` (true/false): True when the CFPB reports a problem loading its data.
- `is_stale` (true/false): True when the newest data is more than 5 business days old.
- `last_loaded_date` (text): The day the CFPB last loaded a batch of complaints (YYYY-MM-DD).
- `license` (text): The licence the data is published under, e.g. 'CC0'.
- `newest_complaint_date` (text): The day the newest published complaint was received (YYYY-MM-DD).
- `summary` (text): One line about the database's size and freshness.
- `total_complaints` (number): How many complaints the CFPB has published.

**Example output**

```json
{
  "has_data_issue": false,
  "is_stale": false,
  "last_loaded_date": "2026-10-21",
  "license": "CC0",
  "newest_complaint_date": "2026-10-21",
  "summary": "The CFPB holds 18,560,908 published complaints, the newest received 2026-10-21, last loaded 2026-10-21.",
  "total_complaints": 18560908
}
```

### Search complaints

Find consumer complaints the CFPB has published, by text, company, product, issue, state, ZIP code, the day received, the company's response and more. Each complaint comes with its product, issue, company, response, state and ZIP code. Returns a page at a time, newest first unless you choose otherwise.

**Inputs**

- Search text (`search_term`, text): Words to look for in the complaint's company, product, issue and other details, e.g. overdraft. AND, OR and NOT work, and quotes find an exact phrase. Leave blank for every complaint.
- Look for the text in (`search_field`, text): Where to look for the search text. Defaults to every field. One of: `all` (Every field), `company` (Company names only). Default: `all`.
- Companies (`company`, list): Only complaints about these companies, named as the CFPB files them, e.g. WELLS FARGO & COMPANY. Pick from the list, or type a name: one that matches nothing is looked up and corrected. Leave blank for every company.
- Products (`product`, list): Only complaints about these products, or a product's sub-product, e.g. Mortgage or Mortgage > FHA mortgage. Leave blank for every product.
- Issues (`issue`, list): Only complaints about these problems, or a problem's sub-issue, e.g. Struggling to pay mortgage. Leave blank for every issue.
- States (`state`, list): Only complaints from consumers in these states or territories. Leave blank for everywhere. One or more of: `AL` (Alabama (AL)), `AK` (Alaska (AK)), `AS` (American Samoa (AS)), `AZ` (Arizona (AZ)), `AR` (Arkansas (AR)), `AA` (Armed Forces Americas (AA)), `AE` (Armed Forces Europe (AE)), `AP` (Armed Forces Pacific (AP)), `CA` (California (CA)), `CO` (Colorado (CO)), and 49 more.
- ZIP codes (`zip_code`, list): Only complaints from these 5-digit ZIP codes, as a list or separated by commas. For privacy the CFPB shortens some to 3 digits, e.g. 941XX.
- Received on or after (`date_received_from`, date): Only complaints the CFPB received on or after this day.
- Received on or before (`date_received_to`, date): Only complaints the CFPB received on or before this day.
- Company responses (`company_response`, list): Only complaints the company answered in one of these ways. One or more of: `Closed with explanation`, `Closed with non-monetary relief`, `Closed with monetary relief`, `Closed without relief`, `Closed with relief`, `Closed`, `In progress`, `Untimely response`.
- Answered on time (`timely`, text): Only complaints the company answered within 15 days, or only those it didn't. Leave blank for both. One of: `Yes` (On time), `No` (Late).
- Submitted by (`submitted_via`, list): Only complaints sent to the CFPB in one of these ways. One or more of: `Web`, `Referral`, `Phone`, `Postal mail`, `Fax`, `Email`.
- Tags (`tags`, list): Only complaints from older Americans (62 or over) or servicemembers, veterans and their families. A complaint can carry both. One or more of: `Older American`, `Servicemember`.
- Leave out products (`exclude_product`, list): Leave out complaints about these products, e.g. Credit reporting or other personal consumer reports, which make up most complaints.
- Order (`sort`, text): Which complaints come first. Best match only means something with search text. One of: `created_date_desc` (Newest first), `created_date_asc` (Oldest first), `relevance_desc` (Best match first). Default: `created_date_desc`.
- Complaints per page (`page_size`, number): How many complaints to return, from 1 to 100. Defaults to 25. From 1 to 100. Default: `25`.
- Page (`page`, number): Which page to return, from 1. Only the first 10,000 complaints of a search can be paged through. From 1 to 10000. Default: `1`.

**Outputs**

- `companies_searched` (list): The companies searched for, spelled the way the CFPB files them. A typed name that matched nothing is looked up and corrected here.
- `complaints` (list): The complaints on this page, in the order asked for.
- `count` (number): How many complaints are on this page.
- `has_more` (true/false): True when a later page holds more complaints.
- `next_page` (number): The page to ask for next, or null on the last page.
- `page` (number): Which page this is, from 1.
- `page_size` (number): How many complaints a page holds.
- `summary` (text): One line saying how many matched and which are shown.
- `total` (number): How many complaints match, across every page.

**Example output**

```json
{
  "companies_searched": [
    "WELLS FARGO & COMPANY"
  ],
  "complaints": [
    {
      "company": "WELLS FARGO & COMPANY",
      "company_public_response": "Company has responded to the consumer and the CFPB and chooses not to provide a public response",
      "company_response": "Closed with non-monetary relief",
      "complaint_id": "12749227",
      "date_received": "2025-03-31",
      "date_sent_to_company": "2025-03-31",
      "issue": "Improper use of your report",
      "product": "Credit reporting or other personal consumer reports",
      "received_at": "2025-03-31T18:49:39Z",
      "state": "CA",
      "sub_issue": "Reporting company used your report improperly",
      "sub_product": "Credit reporting",
      "submitted_via": "Web",
      "summary": "Complaint 12749227 about WELLS FARGO & COMPANY, received 2025-03-31 from CA (Credit reporting or other personal consumer reports: Improper use of your report). Company response: Closed with non-monetary relief.",
      "tags": [],
      "timely_response": true,
      "url": "https://www.consumerfinance.gov/data-research/consumer-complaints/search/detail/12749227",
      "zip_code": "92025"
    },
    {
      "company": "WELLS FARGO & COMPANY",
      "company_public_response": "Company has responded to the consumer and the CFPB and chooses not to provide a public response",
      "company_response": "Closed with explanation",
      "complaint_id": "12737884",
      "date_received": "2025-03-31",
      "date_sent_to_company": "2025-03-31",
      "issue": "Incorrect information on your report",
      "product": "Credit reporting or other personal consumer reports",
      "received_at": "2025-03-31T11:10:48Z",
      "state": "CA",
      "sub_issue": "Public record information inaccurate",
      "sub_product": "Credit reporting",
      "submitted_via": "Web",
      "summary": "Complaint 12737884 about WELLS FARGO & COMPANY, received 2025-03-31 from CA (Credit reporting or other personal consumer reports: Incorrect information on your report). Company response: Closed with explanation.",
      "tags": [
        "Older American",
        "Servicemember"
      ],
      "timely_response": true,
      "url": "https://www.consumerfinance.gov/data-research/consumer-complaints/search/detail/12737884",
      "zip_code": "92595"
    }
  ],
  "count": 2,
  "has_more": true,
  "next_page": 2,
  "page": 1,
  "page_size": 2,
  "summary": "Found 812 complaints; showing 1 to 2, newest first.",
  "total": 812
}
```

### Suggest companies

Find how the CFPB spells a company's name, for the Companies filter: up to 10 names containing your text, the most complained about first.

**Inputs**

- Name contains (`text`, text, required): Part of the company's name, e.g. wells fargo.

**Outputs**

- `best_match` (text): The name that matches the text exactly, ignoring capitals, or else the most complained about one; null when none matched.
- `companies` (list): Company names containing the text, the most complained about first.
- `count` (number): How many company names came back (at most 10).
- `query` (text): The text looked for.

**Example output**

```json
{
  "best_match": "WELLS FARGO & COMPANY",
  "companies": [
    "WELLS FARGO & COMPANY"
  ],
  "count": 1,
  "query": "wells fargo"
}
```

### Suggest ZIP codes

List up to 10 ZIP codes with complaints that start with the digits you give, optionally only in some states.

**Inputs**

- ZIP code starts with (`text`, text, required): The first 1 to 5 digits, e.g. 9410.
- States (`state`, list): Only complaints from consumers in these states or territories. Leave blank for everywhere. One or more of: `AL` (Alabama (AL)), `AK` (Alaska (AK)), `AS` (American Samoa (AS)), `AZ` (Arizona (AZ)), `AR` (Arkansas (AR)), `AA` (Armed Forces Americas (AA)), `AE` (Armed Forces Europe (AE)), `AP` (Armed Forces Pacific (AP)), `CA` (California (CA)), `CO` (Colorado (CO)), and 49 more.

**Outputs**

- `count` (number): How many ZIP codes came back (at most 10).
- `query` (text): The digits looked for.
- `states` (list): The states the ZIP codes were limited to.
- `zip_codes` (list): ZIP codes with complaints that start with the digits.

**Example output**

```json
{
  "count": 8,
  "query": "9410",
  "states": [
    "CA"
  ],
  "zip_codes": [
    "94103",
    "94102",
    "94109",
    "94107",
    "94105",
    "94108",
    "94104",
    "94100"
  ]
}
```
