API Documentation

The BankScorer API gives programmatic access to CRA ratings for all 18,000+ US banks. Available on the Business plan. Get your API key from your Account page.

Authentication

Pass your API key in the Authorization header on every request.

curl https://bankscorer.com/api/v1/banks \
  -H "Authorization: Bearer bs_live_YOUR_KEY"

Endpoints

GET/api/v1/banks

Search and list banks with their current CRA rating.

Query parameters

Param	Type	Description
q	string	Search by bank name (partial match)
state	string	Filter by 2-letter state code (e.g. NY)
size	string	Filter by exam type: Large Bank, Small Bank, Intermediate Small Bank
page	integer	Page number (default: 1)
per_page	integer	Results per page (default: 25, max: 100)

curl "https://bankscorer.com/api/v1/banks?q=chase&state=NY&per_page=5" \
  -H "Authorization: Bearer bs_live_YOUR_KEY"

{
  "data": [
    {
      "id": "3fa85f64-...",
      "name": "JPMORGAN CHASE BANK, N.A.",
      "city": "COLUMBUS",
      "state": "OH",
      "regulator": "OCC",
      "current_rating": {
        "rating": "Outstanding",
        "exam_date": "2024-03-11",
        "exam_type": "Large Bank"
      }
    }
  ],
  "meta": { "total": 18986, "page": 1, "per_page": 5, "total_pages": 3798 }
}

GET/api/v1/banks/:id

Full details for a bank including complete rating history. Get the idfrom the list endpoint or a bank's URL on BankScorer.

curl "https://bankscorer.com/api/v1/banks/3fa85f64-..." \
  -H "Authorization: Bearer bs_live_YOUR_KEY"

{
  "data": {
    "id": "3fa85f64-...",
    "name": "JPMORGAN CHASE BANK, N.A.",
    "city": "COLUMBUS",
    "state": "OH",
    "regulator": "OCC",
    "charter_type": null,
    "ratings": [
      { "exam_date": "2024-03-11", "rating": "Outstanding", "exam_type": "Large Bank", "is_current": true },
      { "exam_date": "2020-03-02", "rating": "Outstanding", "exam_type": "Large Bank", "is_current": false }
    ]
  }
}

Errors

Status	Meaning
401	Missing or invalid API key
403	Valid key but subscription is inactive
404	Bank not found
500	Server error

Ready to get started?

Get your API key from your account page — it's included with every Business plan.

Go to Account View Pricing