Skip to content
Fuzzy Fed ABA Routing Number and Bank Name Lookup.
Branch: master
Clone or download
adamdecaf Merge pull request #59 from adamdecaf/reader-tests
cmd/server: add tests for searcher calls to parse data files
Latest commit d79d413 Jul 12, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
client client: upgrade to openapi-generator 4.0.3 Jul 9, 2019
cmd/server cmd/server: bump up test coverage for data filepaths code Jul 12, 2019
data Add documentation Jan 11, 2019
docs Update FedACHdir.md Jan 29, 2019
pkg/strcmp Limit (#41) Feb 27, 2019
vendor/github.com/prometheus/procfs Remove vendor directory (#50) Apr 30, 2019
.codecov.yml Add .codecov.yml Jan 29, 2019
.gitignore client: regenerate Mar 6, 2019
.travis.yml build: re-enable codecov in CI Jul 9, 2019
ACHDictionary.go Limit (#41) Feb 27, 2019
ACHDictionary_test.go Limit (#41) Feb 27, 2019
AUTHORS populate AUTHORS Jul 9, 2019
CHANGELOG.md docs: changelog++ Jul 9, 2019
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Apr 30, 2019
Dockerfile build: fix FED data files path May 21, 2019
LICENSE Create LICENSE Jan 29, 2019
README.md add environment variables to override command line flags Jul 9, 2019
WIREDictionary.go Limit (#41) Feb 27, 2019
WIREDictionary_test.go Limit (#41) Feb 27, 2019
const.go WIREDirectory Search Filter Feb 8, 2019
fileErrors.go Remove Has from fileErrors.go Feb 8, 2019
go.mod build: go mod tidy Jul 9, 2019
go.sum build: go mod tidy Jul 9, 2019
makefile client: upgrade to openapi-generator 4.0.3 Jul 9, 2019
openapi-generator client: regenerate Mar 6, 2019
openapi.yaml miscellaneous adjustments (#48) Mar 14, 2019
renovate.json renovate: only run on monday Feb 28, 2019
validators.go Edit checks Jan 31, 2019
version.go release v0.3.0-rc1 Jul 9, 2019

README.md

moov-io/fed

GoDoc Build Status Coverage Status Go Report Card Apache 2 licensed

Package github.com/moov-io/fed implements utility services for searching the United States Federal Reserve System such as ABA routing numbers, Financial Institution name lookup and Fed Wire routing information. Moov's primary usage for this project is with ACH origination in our paygate project.

Docs: docs.moov.io | api docs

Project Status

Moov FED is under active development and in production for multiple companies. Please star the project if you are interested in its progress.

Usage

Go library github.com/moov-io/fed offers a Go based search for FEDACH and FEDWIRE Participants.

To get started using Fed download the latest release or our Docker image.

Docs: docs.moov.io | api docs

Note: The Docker image ships with old data files (FedACHdir.txt and fpddir.txt) as example data. In a production deployment updated files should be obtained from your Financial Institution and provided to the server process.

ACH Routing Number Example

Fed can be used to lookup a Financial Institutions for Automated Clearing House (ACH) transfers by their routing number (?routingNumber=...) or name (?name=...):

$ curl -s localhost:8086/fed/ach/search?routingNumber=273976369 | jq .
{
  "achParticipants": [
    {
      "routingNumber": "273976369",
      "officeCode": "O",
      "servicingFRBNumber": "071000301",
      "recordTypeCode": "1",
      "revised": "041513",
      "newRoutingNumber": "000000000",
      "customerName": "VERIDIAN CREDIT UNION",
      "achLocation": {
        "address": "1827 ANSBOROUGH",
        "city": "WATERLOO",
        "state": "IA",
        "postalCode": "50702",
        "postalCodeExtension": "0000"
      },
      "phoneNumber": "3192878332",
      "statusCode": "1",
      "viewCode": "1"
    }
  ],
  "wireParticipants": null
}

Wire Routing Number Example

Fed can be used to lookup a Financial Institutions for FED Wire Messages (FEDWire) by their routing number (?routingNumber=...) or name (?name=...):

$ curl -s localhost:8086/fed/wire/search?routingNumber=273976369 | jq .
{
  "achParticipants": null,
  "wireParticipants": [
    {
      "routingNumber": "273976369",
      "telegraphicName": "VERIDIAN",
      "customerName": "VERIDIAN CREDIT UNION",
      "wireLocation": {
        "city": "WATERLOO",
        "state": "IA"
      },
      "fundsTransferStatus": "Y",
      "fundsSettlementOnlyStatus": " ",
      "bookEntrySecuritiesTransferStatus": "N",
      "date": "20141107"
    }
  ]
}

Configuration

Environmental Variable Description Default
FEDACH_DATA_PATH Filepath to FEDACH data file ./data/FedACHdir.txt
FEDWIRE_DATA_PATH Filepath to FedWIRE data file ./data/fpddir.txt
LOG_FORMAT Format for logging lines to be written as. Options: json, plain - Default: plain
HTTP_BIND_ADDRESS Address for paygate to bind its HTTP server on. This overrides the command-line flag -http.addr. Default: :8086
HTTP_ADMIN_BIND_ADDRESS Address for paygate to bind its admin HTTP server on. This overrides the command-line flag -admin.addr. Default: :9096

FedWire and FedACH data from the Federal Reserve Bank Services

The data and formats in this repository represent a compilation of the FedWire and FedACH data from the Federal Reserve Bank Services site.

FedWire Directory

FedACH Directory

Other resources

Copyright and Terms of Use

(c) Federal Reserve Banks

By accessing the data in this repository you agree to the Federal Reserve Banks' Terms of Use and the E-Payments Routing Directory Terms of Use Agreement.

Disclaimer

THIS REPOSITORY IS NOT AFFILIATED WITH THE FEDERAL RESERVE BANKS AND IS NOT AN OFFICIAL SOURCE FOR THE FEDWIRE AND THE FEDACH DATA.

You can’t perform that action at this time.