Logo
Swift API Sandbox Collections API Documentation

Bad Request: invalid x-bic format

POST {{baseUrl}}/accounts/verification

The service verifies that an account exists and is capable of receiving incoming funds. The service uses the beneficiary bank subscribed as data provider to perform the account verification that usually implies that the account is open, properly identified by the given number and, depending on the jurisdiction and market practices in use where the account is held, that the creditor name matches the name of the account holder. When the beneficiary bank did not subscribe as data provider, SWIFT will use pseudonymized account statistics to perform the account number verification that implies that the account exists and is likely to receive funds and the creditor name will not be verified. SWIFT and the beneficiary banks subscribed as data provider do not take liability for the response and do not provide any guarantee on the outcome of an actual transaction being sent to this account. The information provided is meant to be as accurate as possible at the time that the request was processed. The requester must pass the creditor name and the service provider can use this information as part of the verification or not.

 

Body PARAM

Key Datatype Required Description 



HEADERS

Curl
curl -X POST 'https://sandbox.swift.com/swift-preval/v2/accounts/verification' -H 'x-bic: 123-456' -H 'X-Request-ID: 0f70dd9b-11d4-1d02-049b-9caee3c80982' -H 'X-Request-Date-Time: 1974-01-13T10:25:48.583Z' -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"correlation_identifier":"string","context":"BENR","uetr":"dd3027ea-9460-480c-8ef4-0aed819a5ce8","creditor_account":"string","creditor_name":"string","creditor_address":{"address_type":{"code":"ADDR"},"department":"string","sub_department":"string","street_name":"string","building_number":"string","building_name":"string","floor":"string","post_box":"string","room":"string","post_code":"string","town_name":"string","town_location_name":"string","district_name":"string","country_sub_division":"string","country":"YJ","address_line":["string"]},"creditor_organisation_identification":{"any_bic":"RZIPZHCQ","other":[{"identification":"string","scheme_name":{"code":"stri"},"issuer":"string"}]},"creditor_agent":{"bicfi":"71Q8QA7QYEB","clearing_system_member_identification":{"clearing_system_identification":{"code":"strin"},"member_identification":"string"}},"creditor_agent_branch_identification":"string"}'

ENDPOINTS

    Key Datatype Required Description 
    x-bic
    string (Required) BIC of SWIFT or of the Payment Pre-validation Data Provider. The x-bic value must correspond to the BIC of the beneficiary bank subscribed to the service as Data Provider and performing the beneficiary account validation when the clients want to validate beneficiary account information exclusively with the beneficiary bank. The x- BIC value must be SWIFT BIC (swhqbebb) to use the beneficiary bank when it is subscribed to the service as data provider or to use the pseudonymized account statistics when the beneficiary bank is not subscribed to the service as data provider.
    X-Request-ID
    string Unique end-to-end tracking identifier(ID) of the Payment Pre-validation API service request. Payment Pre-validation users are not required to fill it in for the Payment Pre-validation API request. SWIFT provide the tracking ID which is an uuid as described in IETF RFC 4122 Universally Unique Identifier (UUID) URN Namespace. Pattern - ^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$.
    X-Request-Date-Time
    string The timestamp of the request, based on the client's clock. Request date time must be created and supplied at the time of request. The date-time must be represented as specified in RFC 7231. For example - Sun, 06 Nov 1994 08:49:37 GMT.
    Content-Type
    string
    Accept
    string