Query the directory

in this tutorial, you'll learn how to ✅ identify which instant payments receive services are available to creditor banks through rtp® via tch or fednow® if you are new to real time payments, check out the instant payments this tutorial assumes familiarity with apis for more information, visit the api basics before you begin make sure you have register api endpoints used in this tutorial api description instant payments returns available instant payments receive services for fednow, banks must register each routing transit number ( rtn) individually banks may have partial rtn registration access the directory you’ll check the available services for jp morgan chase bank the api call returns a list of service codes if the bank supports both rtp via tch and fednow , codes for each network will be returned call get /rtp/v1/directory?{queryparam}={queryparamvalue} include at least one query parameter to filter and control the data returned filter name the official name of the financial institution (fi) filter routingnumber the routing number of the recipient account (best practice filter by this value for accuracy) filter participantid the participant id of the fi filter institutionroutingnumber the routing number of the fi enter routing number 021000021 as either routingnumber or institutionroutingnumber to retrieve results for the financial institution sample query using routing number curl x get /rtp/v1/directory 'https //sandbox crbcos com/rtp/v1/directory?filter routingnumber=021000021' a successful api call returns a json response listing the supported instant payments services for routing number 021000021 , associated with jp morgan chase bank the receiveservices object contains the service codes the networkplatform attribute specifies the instant payments network (e g , rtp® or fednow®) if the bank participates in both networks, the response includes a separate list of services for each sample directory response with both networks { "networkplatform" "tch", "routingnumber" "021000021", "participantid" "200000020t1", "name" "jpmorgan chase", "institutionroutingnumber" "200000021", "institutionname" "jpmorgan chase", "receiveservices" \[ "ack", "crdt", "rfi", "rfir", "rfp", "rfpr", "rfrf", "rfrfr", "rmt" ], "receivingconnection" "jpmc", "participantactivationdate" "11/13/2017 12 00 00 am", "extractiondatetime" "9/29/2022 7 00 00 am", "lastmodifiedat" "2022 09 29t14 23 01 9180766 04 00", "networkplatform" "tch", "onlinestatus" "signedon", "onlinestatuschangedat" "2022 09 15t12 22 04 9180766 04 00" }, { "routingnumber" "021000021", "name" "jpmorgan chase bank, na", "receiveservices" \[ "ctsr" ], "lastmodifiedat" "2022 09 29t14 23 01 9180766 04 00", "networkplatform" "fednow", "onlinestatus" "signedon", "onlinestatuschangedat" "2022 09 15t12 22 04 9180766 04 00" } even if a financial institution lists a specific service, it does not guarantee that the creditor or debtor account at that institution is eligible for it available instant payments services for tch code description details crdt credit transfer permits receipt of credit transfer (pacs 008) rfp request for payment permits receipt of request for payment (pain 013) ack payment acknowledgement permits receipt of payment acknowledgement (camt 035) rmt remittance advice permits receipt of remittance advice (remt 001) rfi request for information permits receipt of request for information (camt 026) rfrf request for return of funds permits receipt of request for return of funds (camt 056) rfpr request for payment response permits receipt of request for payment response (pain 014) rfir request for information response permits receipt of request for information response (camt 028) rfrfr request for return of funds response permits receipt of request for return of funds response (camt 029) available instant payments services for fednow code description details ctro credit transfer receive only indicates a fednow participant is enabled to receive but not send customer credit transfer messages ctsr credit transfer receive send indicates a fednow participant is enabled to send and receive customer credit transfer messages rfpr request for payment receive indicates a fednow participant is enabled to receive request for payment messages