Look up financial institutions
Search for financial institutions by name or routing number.
This endpoint returns metadata about each matched institution, including basic identifying details (such as name, routing number, and address) and information about which payment services they support (e.g., ACH, RTP, and Wire).
This can be used to validate a financial institution before initiating payment activity, or to check which payment rails are available for a given routing number.
To access this endpoint using an access token
you'll need to specify the /institutions.read scope.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
{
"ach": [
{
"name": "First Citizens",
"routingNumber": "123456789",
"address": {
"addressLine1": "123 Main Street",
"addressLine2": "Apt 302",
"city": "Boulder",
"stateOrProvince": "CO",
"postalCode": "80301",
"country": "US"
},
"contact": {
"phone": {
"number": "8185551212",
"countryCode": "1"
}
}
}
],
"rtp": [
{
"name": "First Citizens",
"routingNumber": "123456789",
"services": {
"receivePayments": true,
"receiveRequestForPayment": true
}
}
],
"wire": [
{
"name": "First Citizens",
"routingNumber": "123456789",
"address": {
"addressLine1": "123 Main Street",
"addressLine2": "Apt 302",
"city": "Boulder",
"stateOrProvince": "CO",
"postalCode": "80301",
"country": "US"
},
"services": {
"fundsTransferStatus": true,
"fundsSettlementOnlyStatus": false,
"bookEntrySecuritiesTransferStatus": false
}
}
],
"fednow": [
{
"name": "First Citizens",
"routingNumber": "123456789",
"services": {
"receivePayments": true,
"sendPayments": true,
"requestForPayment": true
}
}
]
}Response headers
x-request-id
string
<uuid>
required
Response headers
x-request-id
string
<uuid>
required
Response headers
x-request-id
string
<uuid>
required
Response headers
x-request-id
string
<uuid>
required
Response headers
x-request-id
string
<uuid>
required
Response headers
x-request-id
string
<uuid>
required
Response headers
x-request-id
string
<uuid>
required
Headers
X-Moov-Version
string
Specify an API version.
API versioning follows the format vYYYY.QQ.BB, where
YYYYis the yearQQis the two-digit month for the first month of the quarter (e.g., 01, 04, 07, 10)BBis the build number, starting at.01, for subsequent builds in the same quarter.- For example,
v2024.01.00is the initial release of the first quarter of 2024.
- For example,
The latest version represents the most recent development state. It may include breaking changes and should be treated as a beta release.
When no version is specified, the API defaults to v2024.01.00.
Query parameters
name
string
name or routingNumber is required.
routingNumber
string
routingNumber or name is required.
limit
integer
Response
ach
array<object>
| null
required
Show child attributes
address
object
Show child attributes
addressLine1
string
<=60 characters
required
Pattern
city
string
<=32 characters
required
Pattern
country
string
<=2 characters
required
postalCode
string
<=5 characters
required
stateOrProvince
string
<=2 characters
required
addressLine2
string
<=32 characters
Pattern
contact
object
Show child attributes
phone
object
Show child attributes
countryCode
string
<=1 characters
number
string
<=10 characters
name
string
routingNumber
string
<=9 characters
fednow
array<object>
| null
required
Show child attributes
name
string
routingNumber
string
<=9 characters
services
object
Show child attributes
receivePayments
boolean
required
requestForPayment
boolean
required
sendPayments
boolean
required
rtp
array<object>
| null
required
Show child attributes
name
string
routingNumber
string
<=9 characters
services
object
Show child attributes
receivePayments
boolean
required
receiveRequestForPayment
boolean
required
wire
array<object>
| null
required
Show child attributes
address
object
Show child attributes
addressLine1
string
<=60 characters
required
Pattern
city
string
<=32 characters
required
Pattern
country
string
<=2 characters
required
postalCode
string
<=5 characters
required
stateOrProvince
string
<=2 characters
required
addressLine2
string
<=32 characters
Pattern
name
string
routingNumber
string
<=9 characters
services
object
Show child attributes
bookEntrySecuritiesTransferStatus
boolean
required
fundsSettlementOnlyStatus
boolean
required
fundsTransferStatus
boolean
required