claritystorm/cfpb-consumer-complaints

---
license: other
license_name: public-domain
task_categories:
- tabular-classification
- text-classification
- tabular-regression
tags:
- finance
- consumer-protection
- complaints
- nlp
- fintech
- united-states
pretty_name: CFPB Consumer Financial Complaints 2011-Present
size_categories:
- 10M<n<100M
---

# CFPB Consumer Financial Complaints 2011–Present

Every consumer financial complaint submitted to the Consumer Financial
Protection Bureau (CFPB) since 2011 — cleaned, structured, and ready
for analysis. 14M+ records covering credit reporting, debt collection,
mortgages, credit cards, banking, and more, with free-text consumer
narratives for 3.75M+ complaints.

**This repository contains a 1,000-row sample (Public Domain).**
Full dataset (CSV + Parquet) available at [claritystorm.com/datasets/cfpb-complaints](https://claritystorm.com/datasets/cfpb-complaints).

## Quick Start

```python
from datasets import load_dataset
ds = load_dataset("claritystorm/cfpb-consumer-complaints")

import pandas as pd
df = pd.read_csv("sample_1000.csv")
print(df["product_normalised"].value_counts())
print(df["submitted_via"].value_counts())
```

## Schema (selected fields)

| Field | Type | Description |
|-------|------|-------------|
| complaint_id | int | CFPB unique complaint identifier |
| date_received | string | Date CFPB received complaint (YYYY-MM-DD) |
| year | int | Year received (derived) |
| month | int | Month received (derived) |
| product | string | Financial product category (original) |
| product_normalised | string | Standardised product category |
| sub_product | string | Product sub-category |
| issue | string | Issue type |
| sub_issue | string | Issue sub-type |
| consumer_narrative | string | Consumer complaint text (free text, ~1.5M records) |
| has_narrative | int | 1 if narrative was provided, 0 otherwise |
| company | string | Company the complaint is about |
| state | string | US state (2-letter code) |
| zip_code | string | 5-digit ZIP code |
| submitted_via | string | Channel: Web / Phone / Referral / Postal mail / etc. |
| company_response | string | Company response to consumer |
| timely_response | int | 1 if company responded timely, 0 otherwise |
| consumer_disputed | int | 1 if consumer disputed company response |
| tags | string | Servicemember / Older American / Older American, Servicemember |

## Source

Consumer Financial Protection Bureau (CFPB) — Consumer Complaint Database.
CFPB data is a US federal government work in the **public domain** (17 U.S.C. 105).

Processed by [ClarityStorm Data](https://claritystorm.com).