Consumer Financial Protection Bureau Search API
The Search API from Consumer Financial Protection Bureau — 3 operation(s) for search.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/consumer-financial-protection-bureau-search-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: CFPB Consumer Complaint Database Search API
description: Public REST + JSON API for searching the Consumer Financial Protection Bureau's Consumer Complaint Database (CCDB), a daily-updated record of complaints submitted by consumers about financial products and services and the companies that respond to them. The API powers the public CCDB search experience at consumerfinance.gov/data-research/consumer-complaints and is documented at cfpb.github.io/ccdb5-api.
version: '1'
contact:
name: CFPB Open Tech
url: https://cfpb.github.io/
license:
name: Creative Commons CC0 1.0 Universal
url: https://creativecommons.org/publicdomain/zero/1.0/
servers:
- url: https://www.consumerfinance.gov/data-research/consumer-complaints/search/api/v1
description: Production CCDB search API
tags:
- name: Search
paths:
/:
get:
operationId: searchComplaints
summary: Search complaints
description: Full-text search across the Consumer Complaint Database with faceted filters and pagination.
tags:
- Search
parameters:
- name: search_term
in: query
schema:
type: string
description: Free-text search across complaint narratives.
- name: field
in: query
schema:
type: string
enum:
- all
- complaint_what_happened
- company_public_response
- name: frm
in: query
schema:
type: integer
default: 0
description: Result offset (0-based).
- name: size
in: query
schema:
type: integer
default: 25
maximum: 100
- name: sort
in: query
schema:
type: string
enum:
- relevance_desc
- relevance_asc
- created_date_desc
- created_date_asc
- name: format
in: query
schema:
type: string
enum:
- json
- csv
- name: date_received_min
in: query
schema:
type: string
format: date
- name: date_received_max
in: query
schema:
type: string
format: date
- name: company
in: query
schema:
type: array
items:
type: string
- name: product
in: query
schema:
type: array
items:
type: string
- name: state
in: query
schema:
type: array
items:
type: string
minLength: 2
maxLength: 2
- name: tags
in: query
schema:
type: array
items:
type: string
responses:
'200':
description: Matching complaints
content:
application/json:
schema:
$ref: '#/components/schemas/SearchResponse'
text/csv: {}
/{complaintId}/:
get:
operationId: getComplaint
summary: Get a single complaint by ID
tags:
- Search
parameters:
- name: complaintId
in: path
required: true
schema:
type: string
responses:
'200':
description: A single complaint
content:
application/json:
schema:
$ref: '#/components/schemas/Complaint'
'404':
description: Not found
/suggest/:
get:
operationId: getSuggestions
summary: Autocomplete suggestions
tags:
- Search
parameters:
- name: text
in: query
required: true
schema:
type: string
- name: size
in: query
schema:
type: integer
default: 10
responses:
'200':
description: Suggestion list
content:
application/json: {}
components:
schemas:
SearchResponse:
type: object
properties:
hits:
type: object
properties:
total:
type: object
properties:
value:
type: integer
relation:
type: string
hits:
type: array
items:
type: object
properties:
_source:
$ref: '#/components/schemas/Complaint'
_id:
type: string
_score:
type: number
aggregations:
type: object
Complaint:
type: object
properties:
complaint_id:
type: string
date_received:
type: string
format: date
date_sent_to_company:
type: string
format: date
product:
type: string
sub_product:
type: string
issue:
type: string
sub_issue:
type: string
company:
type: string
company_response:
type: string
company_public_response:
type: string
consumer_consent_provided:
type: string
consumer_disputed:
type: string
complaint_what_happened:
type: string
state:
type: string
zip_code:
type: string
tags:
type: string
timely:
type: string
submitted_via:
type: string