Facility By Name & Country

GET api.bic-code.org/v1/facilities/byName/{{countryCode}}?name={{name}}&codeProvider={{codeProvider}}

Finds all facilities with a name that contain the search term within a country using the ISO 3166 Country Code. Useful for when you know the name or partial name of a facility and wish to identify the correct facility code to use in your messages and/or update your internal systems. You must provide the country code that you wish to search within.

i.e.

For container facilities in Great Britain * /facilities/byName/GB

Pass the mandatory field for Name into the querystring.

Optional field(s): * Code Provider (BIC|SMDG)

NOTE As with most name and address fields you may find that the name is noted slightly differently to your search, it is better to stick to the official name of the company operating the facility rather than a short version or abbreviation.

Request Params

RESPONSES

status: OK

{"results":[{"code":"GBBHXNTRA","codeProvider":"BIC","unLocode":"GBBHX","countryCode":"GB","facility":{"name":"Central Container Services","address":{"street":" West Bromwich Street","city":"Oldbury","state":"","postcode":"B69 3AY","country":"United Kingdom"},"formattedAddress":"West Bromwich Street, Oldbury, B69 3AY, United Kingdom","geographicalCoordinate":{"latitude":"52.5113888","longitude":"-2.0183589"}},"operator":{"name":"Central Container Services"}}]}