Skip to content

Fed data

Institution lookup by routing number link

moov.fed.lookupByRoutingNumber(options?)

Get financial institutions details, such as name, address, and phone number from a routing number lookup. This is useful for on-the-fly validation when a customer is connecting their accounts.

Parameters link

  • routingNumber string
  • exact boolean

Returns link

This method returns a Promise which resolves with the results object. If the routing number has a match, the object will include a results field that contains the object describing the institution, along with success: true. If there is no match, the object will contain success: false.

If exact is false and there are multiple matches, the result will include an array of institution objects.

tip

Routing numbers are numeric and have a length of 9 digits, so you can easily implement client-side validation ahead of requesting a lookup.

1
2
3
4
5
6
7
8
9
<!-- inline validation -->
<input type="text" inputmode="numeric" minlength="9" maxlength="9" required>

<!-- simple check in JavaScript -->
<script>
  if (field.value?.length === 9) {
    const { result } = await moov.fed.lookupByRoutingNumber(field.value);
  }
</script>