The Consumer Financial Protection Bureau
Learn more about home mortgage data, download the data yourself, or build new tools using our API
COMMUNITYNO AUTH0 INSTALLS
OpenAPI Specificationv3.0
{
"swagger": "2.0",
"schemes": [
"https"
],
"host": "api.consumerfinance.gov:443",
"basePath": "/",
"info": {
"description": "Learn more about home mortgage data, download the data yourself, or build new tools using our API.",
"title": "The Consumer Financial Protection Bureau",
"version": "1.0",
"x-apisguru-categories": [
"financial"
],
"x-logo": {
"url": "https://api.apis.guru/v2/cache/logo/http_cfpb.github.io_img_logo_210.png"
},
"x-origin": [
{
"converter": {
"url": "https://github.com/lucybot/api-spec-converter",
"version": "2.7.11"
},
"format": "swagger",
"url": "https://api.consumerfinance.gov/api-docs",
"version": "1.2"
}
],
"x-providerName": "consumerfinance.gov"
},
"externalDocs": {
"url": "http://cfpb.github.io/api/hmda/"
},
"tags": [
{
"description": "Operations about datasets",
"name": "data"
},
{
"description": "Operations about LAR data",
"name": "hmda"
}
],
"paths": {
"/data": {
"get": {
"operationId": "getDatasets",
"produces": [
"application/json",
"application/xml"
],
"responses": {
"200": {
"description": "No response was specified"
}
},
"summary": "Get a list of all datasets.",
"tags": [
"data"
]
}
},
"/data/hmda": {
"get": {
"operationId": "getDatasetHmda",
"produces": [
"application/json",
"application/xml",
"text/javascript"
],
"responses": {
"200": {
"description": "No response was specified"
}
},
"summary": "Get metadata for this dataset.",
"tags": [
"hmda"
]
}
},
"/data/hmda/concept/{concept}": {
"get": {
"operationId": "getConceptHmda",
"parameters": [
{
"description": "Name of concept",
"in": "path",
"name": "concept",
"required": true,
"type": "string"
}
],
"produces": [
"application/json",
"application/xml",
"text/javascript"
],
"responses": {
"200": {
"description": "No response was specified"
}
},
"summary": "Get information about a particular concept in this dataset.",
"tags": [
"hmda"
]
}
},
"/data/hmda/slice/{slice}": {
"get": {
"operationId": "querySliceHmda",
"parameters": [
{
"description": "Name of slice",
"in": "path",
"name": "slice",
"required": true,
"type": "string"
},
{
"description": "Fields to return, separated by commas.",
"in": "query",
"name": "$select",
"required": false,
"type": "string"
},
{
"description": "Conditions to search for in the slice, in SQL WHERE style.",
"in": "query",
"name": "$where",
"required": false,
"type": "string"
},
{
"description": "Fields to group by, summarizing the data, separated by commas.",
"in": "query",
"name": "$group",
"required": false,
"type": "string"
},
{
"description": "Number of records to return, 100 by default. Enter 0 for no limit.",
"in": "query",
"name": "$limit",
"required": false,
"type": "integer"
},
{
"description": "Number of records to skip.",
"in": "query",
"name": "$offset",
"required": false,
"type": "integer"
},
{
"description": "Fields to order by, separated by commas. ASC and DESC can be used to modify the order.",
"in": "query",
"name": "$orderBy",
"required": false,
"type": "string"
},
{
"description": "JavaScript callback to invoke. Only useful with JSONP requests.",
"in": "query",
"name": "$callback",
"required": false,
"type": "string"
}
],
"produces": [
"application/json",
"application/xml",
"text/javascript",
"text/csv"
],
"responses": {
"200": {
"description": "No response was specified",
"schema": {
"$ref": "#/definitions/QueryResponse"
}
}
},
"summary": "Query a slice in this dataset.",
"tags": [
"hmda"
]
}
},
"/data/hmda/slice/{slice}/metadata": {
"get": {
"operationId": "getSliceMetadataHmda",
"parameters": [
{
"description": "Name of slice",
"in": "path",
"name": "slice",
"required": true,
"type": "string"
}
],
"produces": [
"application/json",
"application/xml",
"text/javascript"
],
"responses": {
"200": {
"description": "No response was specified"
}
},
"summary": "Get the metadata for a slice in this dataset.",
"tags": [
"hmda"
]
}
},
"/data/{dataset}": {
"get": {
"operationId": "getDataset",
"parameters": [
{
"description": "Name of dataset",
"in": "path",
"name": "dataset",
"required": true,
"type": "string"
}
],
"produces": [
"application/json",
"application/xml"
],
"responses": {
"200": {
"description": "No response was specified"
}
},
"summary": "Get metadata about a dataset.",
"tags": [
"data"
]
}
}
},
"definitions": {
"QueryResponse": {
"description": "Response to a slice query.",
"properties": {
"size": {
"type": "integer"
},
"total": {
"type": "integer"
}
},
"required": [
"total",
"size"
]
}
}
}