Sorry, you need to enable JavaScript to visit this website.

KYC Registry API Sandbox Guide

If you are a current SWIFT KYC Registry customer, you may be assigned the kyc-developer role and you will see KYC Registry API in the product list, please check the box and provide an application name and click Create App.

If you have the default developer role in your profile, you will instead see the option to select the KYC Registry API (limited) with partial API response samples in the product list. Interested to see the full API samples? Contact developer-support@swift.com to request kyc-developer role.

 

KYC Registry API uses token base authentication in sandbox and live. Retrieve consumer-key and consumer-secret from the app you created and use the OAuth API to generate a token.

Sandbox OAuth URL:

  • https://sandbox.swift.com/oauth2/v1/token

Use the hardcoded value for your credentials to generate a valid token (only in sandbox):

  • 'username' (request body) = sandbox-id
  • 'password' (request body) = sandbox-key

 

KYC Registry API: https://sandbox.swift.com/kycr/v1

KYC Registry API (limited): https://sandbox.swift.com/kyc/v1

 

Valid BICs for Data Retrieval API

  • Set BIC to BITIAAAXXXX
  • Set BIC to BITIBBBGXXX
  • Set BIC to RSWCSSSGXXX
  • Set BIC to RSWCUUUUXXX
  • Set BIC to LONGBRBRXXX
  • Set BIC to AFFIJPHQXXX
  • Set BIC to CIBBSGHQXXX
  • Set BIC to MYBBTHHQXXX
  • Set BIC to ABCDEF12XXX

Valid BICs for Document Retrieval API

  • Set BIC to AFFIJPHQXXX and documentId to 4200568004 to retrieve one specific document

  • Additional document retrieval list is on Postman "Document by Id" description

Valid BICs for Profile Retrieval API

  • Set BIC to LONGBRBRXXX to download the sample KYC folders and files
  • Set BIC to AFFIJPHQXXX to download the sample KYC folders and files
  • Set BIC to CIBBSGHQXXX to download the sample KYC folders and files
  • Set BIC to MYBBTHHQXXX to download the sample KYC folders and files
  • Set BIC to Blank or 'INVALID_REQUEST' to trigger error response
  • Set BIC to 'NO_DATA_FOUND' to trigger error response
  • Set BIC to 'FORBIDDEN' to trigger error response

 

Getting Started

Try in Postman!