Ireland National Sort Code (NSC) API Lookup Documentations

Our National Sort Code (NSC) API lookup function allows you to automate National Sort Code (NSC) Lookup by a simple HTTP GET request. For casual user who is not interested to use API, similar function is available in National Sort Code (NSC) page.

The function will return the result in either XML or JSON format. The default format is XML, but if you prefer to have the result in JSON format simply specify JSON format in the request. You can parse both format easily into various programming languages and platforms.

This page will describe on how to use our National Sort Code (NSC) API and the expected result you will receive from our systems.

As part of system security and protection, you require to have an API key in order to access our API function, which will be given once you register for API Access.

How to do National Sort Code (NSC) Lookup through API?


National Sort Code (NSC) Lookup through our API is very simple. What you need to do is make a GET request.

General API Call Format

The default result format is in XML. If you want to get the result in this format, simply follow the API request as below,


https://api.bank.codes/ie-nsc/?format=[FORMAT]&api_key=[API_KEY]&nsc=[NSC]

OR
https://api.bank.codes/ie-nsc/[FORMAT]/[API_KEY]/[NSC]/

Input DataExplanation
[FORMAT]Specify the format of the output. Accept "xml" or "json"
[API_KEY]API Key assign to your account
[NSC]National Sort Code (NSC) which you would like to check. We only accept XXXXXX format.

1. XML Format Example


https://api.bank.codes/ie-nsc/?format=xml&api_key=9fc53b3db09ca830488d19546a4fc2a1&nsc=980180

OR
https://api.bank.codes/ie-nsc/xml/9fc53b3db09ca830488d19546a4fc2a1/980180/

Expected Result in XML


<result>
  <nsc>980180</nsc>
  <bank></bank>
  <bic>ULSBGB2BXXX</bic>
  <branch>Antrim</branch>
  <building></building>
  <street>8 Market Square</street>
  <city>Antrim</city>
  <postcode>BT41 4AT</postcode>
  <county>980180</county>
  <country>Northern Ireland</country>
  <pobox></pobox>
  <telephone>4428 94463117</telephone>
  <fax>4428 94428289</fax>
  <currency>GBP</currency>
  <sepa>YES</sepa>
  <valid>true</valid>
</result>

2. JSON Format Example


https://api.bank.codes/ie-nsc/?format=json&api_key=9fc53b3db09ca830488d19546a4fc2a1&nsc=980180

OR
https://api.bank.codes/ie-nsc/json/9fc53b3db09ca830488d19546a4fc2a1/980180/

Expected Result in JSON


{
    "nsc": "980180",
    "bank": "Ulster Bank",
    "bic": "ULSBGB2BXXX",
    "branch": "Antrim",
    "building": "",
    "street": "8 Market Square",
    "city": "Antrim",
    "postcode": "BT41 4AT",
    "county": "",
    "country": "Northern Ireland",
    "pobox": "",
    "telephone": "4428 94463117",
    "fax": "4428 94428289",
    "currency": "GBP",
    "sepa": "YES",
    "valid": "true"
}

3. Error Messages

In some cases, the API may return a response containing error message. Below you can find a description of all possible error messages.

Error IDError MessageExplanation
1001API Key Not SpecifiedYou need to specify your API Key while making API request. Kindly check the API Key in user area.
1002Invalid API KeyPlease make sure that you specify the correct API Key assign to your account. Kindly check the correct API Key in the user area.
1003Suspended API KeyYour API Key was suspended due to system abuse. Kindly contact support.
1004API Usage Limit ExceededYou have exceeded the daily limit allocated to your account. You may purchase additional credit in the user area.
1005NSC Not SpecifiedYou need to specify National Sort Code (NSC) you want to check.
1006Invalid NSCPlease make sure that you specify National Sort Code (NSC) in the correct format in xxxxxx format.
1007NSC Not FoundThe National Sort Code (NSC) that you submitted is not found in our database.