Number of APIs: 33
One of SWIFT's latest delivery channels for SWIFTRef reference data are Application Programming Interfaces (APIs). APIs offer financial institutions, corporates and third party service providers an automated data look-up service for real-time identification and validation of critical payments reference data within the SWIFTRef utility. v4.0.0 Release notes OpenAPI changes For a given BIC and a given currency code, and optionally an asset category, you can retrieve the Standing Settlement Instructions (SSIs). One or more SSIs can be returned. The V4 is based on the SSI Plus V3 directory. The v1.6 was based on SSI Plus V2 directory. Because the structure of SSI Plus V3 differs from the SSI Plus V2, there are several changes in the parameters:
* Some request parameters changed name:
* You can check whether an IBAN is valid, that is its country code, structure, length, and checksum are valid. It also checks that the bank ID exists and that it is allowed for use in the IBANs. If the bank ID is not allowed, then it is listed in the Exclusion List. This list contains bank IDs that must not be used in IBANs. This validity call allows for very fast, low overhead checking of the validity of an IBAN. With the new optional request parameter For a given BIC, you can retrieve the details of that BIC, that is the bank name or business name, and the address. The V4 features ISO 20022-compliant attributes (see https://www.swift.com/resource/structured-ordering-and-beneficiary-customer-data-payments-1).
* Get details for a National ID: For a given National ID, you can retrieve the details of that National ID, that is the bank name or business name, and the address.
You must provide either a country code, or an indication to which scheme the National ID belongs. You can also receive the National ID's data elements (such as the name and address in the local language instead of in English),
if you add the URL extension The V4 features ISO 20022-compliant attributes (see https://www.swift.com/resource/structured-ordering-and-beneficiary-customer-data-payments-1); all available national ID schemes are now returned (idtype, nationalidtype, isoclctype).
* Validate National ID: `GET /v4/nationalids/{national_id}/validity` All available national ID schemes are available as input and returned to output (idtype, nationalidtype, isoclctype).
* Get BICs of a National ID: `GET /v4/nationalids/{national_id}/bics` All available national ID schemes are available as input (idtype, nationalidtype, isoclctype).
* Get National IDs of a BIC: `GET /v4/bics/{bic}/nationalids` All available national ID schemes are now returned (idtype, nationalidtype, isoclc_type); Contact Support:
Name: Standards & Developer Hub
Email: developer-support@swift.com
Accept
now used for the customer expected format (JSON/XML):
application/json
or application/xml
;
[ {errorObject1}, {errorObject2}, ... ]
;more_info
error attribute became optional.API-Status
(API verbose) removed.
GET /v4/pmis/participants
GET /v4/pmis/participants/{participant_record_id}
GET /v4/pmis/{service_id}/structure
GET /v4/pmis/{service_id}
GET /v4/pmis
GET /v4/bics/{bic}/connected_bic
GET /v4/bbans/elements
GET /v4/ibans
GET /v4/bics/{bic}/connected_bic
currency_code
changed to iso_currency_code
* ssi_category
changed to asset_category
* The asset category covers now all asset categories listed in the SSI Plus V3 directory.
* Many new response attributes
* Check validity of an IBAN (SEPA-only option added): GET /v4/ibans/{iban}/validity
sepa_only
, you can validate a SEPA IBAN.
* One new request parameter added: sepa_only
* Get details for a BIC: GET /v4/bics/{bic}
GET /v4/national_ids/{national_id}
&only_local_language=true
.
However, the local language elements are available only for a subset of all National IDs.AN
and FN
type attribute, previously used to flag items as Alternative National ID Type
or Foreign National ID Type
, are not returned anymore.
GET {{baseUrl}}/national_ids/:national_id/bics?country_code=NZ
POST https://sandbox.swift.com/oauth2/v1/revoke
GET {{baseUrl}}/bbans/elements?country_code=BE
GET {{baseUrl}}/leis/:lei
ENDPOINTS