CFPB Consumer Complaints
App · 6 actions
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.
Actions
| Action | What it does |
|---|---|
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| Suggest ZIP codes | List up to 10 ZIP codes with complaints that start with the digits you give, optionally only in some states. |
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_bytext - 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_termtext - 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_fieldtext - Where to look for the search text. Defaults to every field.One of:
all(Every field),company(Company names only). Default:all. - Companies
companylist - 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
productlist - Only complaints about these products, or a product's sub-product, e.g. Mortgage or Mortgage > FHA mortgage. Leave blank for every product.
- Issues
issuelist - Only complaints about these problems, or a problem's sub-issue, e.g. Struggling to pay mortgage. Leave blank for every issue.
- States
statelist - 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_codelist - 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_fromdate - Only complaints the CFPB received on or after this day.
- Received on or before
date_received_todate - Only complaints the CFPB received on or before this day.
- Company responses
company_responselist - 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
timelytext - 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_vialist - Only complaints sent to the CFPB in one of these ways.One or more of:
Web,Referral,Phone,Postal mail,Fax,Email. - Tags
tagslist - 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_productlist - Leave out complaints about these products, e.g. Credit reporting or other personal consumer reports, which make up most complaints.
- Most groups
limitnumber - The most groups to list, largest first, from 1 to 1000. Defaults to 25.From 1 to 1000. Default:
25.
Outputs
companies_searchedlist- The companies searched for, spelled the way the CFPB files them. A typed name that matched nothing is looked up and corrected here.
countnumber- How many groups are listed, at most the limit asked for.
group_bytext- What the complaints were grouped by, e.g. 'product'.
groupslist- The groups, the largest first.
summarytext- One line with the total and the largest group.
totalnumber- How many complaints match.
total_groupsnumber- How many groups the matching complaints fall into.
Example output
{
"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_idtextRequired - The complaint's number, e.g. 12749227, or the address of its page on consumerfinance.gov.
Outputs
companytext- The company it is about, as the CFPB names it.
company_public_responsetext- The statement the company chose to publish about it, if any.
company_responsetext- How the company answered, e.g. 'Closed with explanation' or 'In progress'.
complaint_idtext- The CFPB's number for the complaint, e.g. '12749227'.
date_receivedtext- The day the CFPB received it (YYYY-MM-DD, UTC).
date_sent_to_companytext- The day the CFPB sent it to the company (YYYY-MM-DD, UTC).
issuetext- The problem the consumer named, e.g. 'Problem with a purchase'.
last_loaded_attext- When the CFPB last loaded this complaint into its public database (ISO 8601, UTC).
producttext- The product the consumer named, e.g. 'Credit card'.
received_attext- When the CFPB received it (ISO 8601, UTC).
statetext- The two-letter code of the consumer's state, e.g. 'CA'.
sub_issuetext- The problem in more detail, when the consumer gave it.
sub_producttext- The kind of product, e.g. 'General-purpose credit card'.
submitted_viatext- How it was sent to the CFPB, e.g. 'Web' or 'Phone'.
summarytext- One line about the complaint: who it is about, when and where it came from, the product and issue, and the company's response.
tagslist- 'Older American' (62 or over) and 'Servicemember' when they apply.
timely_responsetrue/false- True when the company answered within 15 days.
urltext- The complaint's page on consumerfinance.gov.
zip_codetext- The consumer's ZIP code. For privacy some show only their first 3 digits, e.g. '941XX'.
Example output
{
"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_issuetrue/false- True when the CFPB reports a problem loading its data.
is_staletrue/false- True when the newest data is more than 5 business days old.
last_loaded_datetext- The day the CFPB last loaded a batch of complaints (YYYY-MM-DD).
licensetext- The licence the data is published under, e.g. 'CC0'.
newest_complaint_datetext- The day the newest published complaint was received (YYYY-MM-DD).
summarytext- One line about the database's size and freshness.
total_complaintsnumber- How many complaints the CFPB has published.
Example output
{
"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_termtext - 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_fieldtext - Where to look for the search text. Defaults to every field.One of:
all(Every field),company(Company names only). Default:all. - Companies
companylist - 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
productlist - Only complaints about these products, or a product's sub-product, e.g. Mortgage or Mortgage > FHA mortgage. Leave blank for every product.
- Issues
issuelist - Only complaints about these problems, or a problem's sub-issue, e.g. Struggling to pay mortgage. Leave blank for every issue.
- States
statelist - 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_codelist - 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_fromdate - Only complaints the CFPB received on or after this day.
- Received on or before
date_received_todate - Only complaints the CFPB received on or before this day.
- Company responses
company_responselist - 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
timelytext - 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_vialist - Only complaints sent to the CFPB in one of these ways.One or more of:
Web,Referral,Phone,Postal mail,Fax,Email. - Tags
tagslist - 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_productlist - Leave out complaints about these products, e.g. Credit reporting or other personal consumer reports, which make up most complaints.
- Order
sorttext - 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_sizenumber - How many complaints to return, from 1 to 100. Defaults to 25.From 1 to 100. Default:
25. - Page
pagenumber - 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_searchedlist- The companies searched for, spelled the way the CFPB files them. A typed name that matched nothing is looked up and corrected here.
complaintslist- The complaints on this page, in the order asked for.
countnumber- How many complaints are on this page.
has_moretrue/false- True when a later page holds more complaints.
next_pagenumber- The page to ask for next, or null on the last page.
pagenumber- Which page this is, from 1.
page_sizenumber- How many complaints a page holds.
summarytext- One line saying how many matched and which are shown.
totalnumber- How many complaints match, across every page.
Example output
{
"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
texttextRequired - Part of the company's name, e.g. wells fargo.
Outputs
best_matchtext- The name that matches the text exactly, ignoring capitals, or else the most complained about one; null when none matched.
companieslist- Company names containing the text, the most complained about first.
countnumber- How many company names came back (at most 10).
querytext- The text looked for.
Example output
{
"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
texttextRequired - The first 1 to 5 digits, e.g. 9410.
- States
statelist - 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
countnumber- How many ZIP codes came back (at most 10).
querytext- The digits looked for.
stateslist- The states the ZIP codes were limited to.
zip_codeslist- ZIP codes with complaints that start with the digits.
Example output
{
"count": 8,
"query": "9410",
"states": [
"CA"
],
"zip_codes": [
"94103",
"94102",
"94109",
"94107",
"94105",
"94108",
"94104",
"94100"
]
}