Skip to content

Getting Started

What is FED

Moov FED implements an HTTP interface to search FEDWIRE and FEDACH data from the Federal Reserve Bank Services.

source: U.S. DEPARTMENT OF THE TREASURY

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

FED can be used stand alone to search for routing numbers by Financial institution name, city, state and postal code and routing number. It can also be used in conjunction with ACH and WIRE to validate routing numbers.

Running Moov FED Server

Moov FED can be deployed in multiple scenarios.

  • Binary Distributions are released with every versioned release. Frequently added to the VM/AMI build script for the application needing Moov FED.
  • Our hosted api.moov.io is updated with every versioned release. Our Kubernetes example is what Moov utilizes in our production environment.
  • A Docker container is built and added to Docker Hub with every versioned released.

Binary Distribution

Download the latest Moov FED server release for your operating system and run it from a terminal.

host:~ $ cd ~/Downloads/
host:Downloads $ ./fed-darwin-amd64 
ts=2019-06-20T23:23:44.870717Z caller=main.go:75 startup="Starting fed server version v0.2.0"
ts=2019-06-20T23:23:44.871623Z caller=main.go:135 transport=HTTP addr=:8086
ts=2019-06-20T23:23:44.871692Z caller=main.go:125 admin="listening on :9096"

Next Connect to Moov FED

Docker Container

Moov FED is dependent on Docker being properly installed and running on your machine. Ensure that Docker is running. If your Docker client has issues connecting to the service review the Docker getting started guide if you have any issues.

host:~ $ docker ps
CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
host:~ $ 

Execute the Docker run command

host:~ $ docker run moov/fed:latest
ts=2019-06-21T17:03:23.782592Z caller=main.go:69 startup="Starting fed server version v0.2.0"
ts=2019-06-21T17:03:23.78314Z caller=main.go:129 transport=HTTP addr=:8086
ts=2019-06-21T17:03:23.783252Z caller=main.go:119 admin="listening on :9096"

OSX Users

You will need to use port forwarding: $ docker run -p 8080:8080 -p 9090:9090 moov/fed:latest)

Next Connect to Moov FED

Kubernetes

The following snippet runs the FED Server on Kubernetes in the apps namespace. You could reach the fed instance at the following URL from inside the cluster.

# Needs to be ran from inside the cluster
$ curl http://fed.apps.svc.cluster.local:8086/ping
PONG

$ curl -s localhost:8086/fed/ach/search?routingNumber=273976369 | jq .

Kubernetes manifest - save in a file (fed.yaml) and apply with kubectl apply -f fed.yaml.

Connecting to Moov FED

The Moov FED service will be running on port 8086 (with an admin port on 9096).

Confirm that the service is running by issuing the following command or simply visiting the url in your browser localhost:8086/ping

$ curl http://localhost:8086/ping 
PONG
$ 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
    }

Other resources

© 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.