Skip to main content
POST
Returns the banks insured by the US Federal Deposit Insurance Corporation that match a name or FDIC certificate number: whether each is open and insured, location, regulator, charter class, date established, website, total assets and total deposits. Use it to check that a bank is real, insured and still open. Credit unions are not included.

Authentication

Requires x402 payment in the payment-signature header.

Request Body

string
The bank’s name, for example Grasshopper Bank. A text match: similarly named banks are returned too. 2 to 100 characters.
integer
The FDIC certificate number, for example 59113. An exact match; preferred over a name. At least 1.
integer
Most banks to return. From 1 to 10. Defaults to 5.

Response (200 OK)

Top-level envelope: success (boolean) and data (object). All fields below are nested under data.
string
Durable job ID for audit and lookup
string
Job status: completed
string
Always company_bank_profile
object
The answer, described under Result below
object
Where the answer came from and when
boolean
true when the answer was served from OneShot’s store of earlier lookups (or its own copy of a public dataset), false when the source was asked for this call
string
When the record was obtained from its source, as an ISO 8601 UTC time; equals evidence.retrieved_at
string
The public body the data comes from. Always US Federal Deposit Insurance Corporation.
string
public when the data comes from a public body, commercial otherwise
string
When the lookup was made, as an ISO 8601 UTC time
string | null
When the source says the fact was last updated, or null when the source gives no date

Result

Nested under data.result.
integer
How many institutions matched in all; may be more than were returned.
object[]
Matching institutions, best match first; empty when none match.
string | null
The institution’s name as the source holds it. null when the source gives no value.
integer | null
The FDIC certificate number; use it to tell similarly named banks apart. null when the source gives no value.
boolean
True when the institution is currently open and insured by the FDIC.
string | null
City. null when the source gives no value.
string | null
Two-letter state code. null when the source gives no value.
string | null
Primary federal regulator code: OCC, FDIC, FED or STATE. null when the source gives no value.
string | null
The FDIC institution class code, for example N for a national commercial bank. null when the source gives no value.
string | null
Date the institution began operations, YYYY-MM-DD. null when the source gives no value.
string | null
Website. null when the source gives no value.
number | null
Total assets in US dollars, as of reported_on. null when the source gives no value.
number | null
Total deposits in US dollars, as of reported_on. null when the source gives no value.
string | null
End date of the reporting period the assets and deposits are from, YYYY-MM-DD. null when the source gives no value.
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers 200.

Notes

  • Give exactly one of name and fdic_certificate.
  • Each institution has its name, certificate number, whether it is currently open and insured, city and state, primary federal regulator, charter class code, the date it was established, its website, and its total assets and total deposits in US dollars as of the reporting date.
  • A name is a text match, so similarly named banks come back too, best match first: tell them apart by the certificate number on each row, and prefer the certificate number when you have it, since it is an exact match.
  • Closed institutions are included, with active false.
  • total is the number of institutions that matched, which may be more than limit. No match is a completed result with total 0 and an empty list.
  • Results return inline. The finished job stays available at /v1/requests/{request_id}