---
updatedAt: 2026-05-11T02:23:58.000Z
agentTools:
  projectIndex: https://developers.sygna.io/llms.txt
---

# VASP/CDD

This API may differ from your position as originating or beneficiary VASP:

(1) When you are an originaing VASP, you need to configure the callbacks of this API (which callback_type is "REQUEST_CDD") in order to receive the CDD request from the beneficiary VASP.

![](https://i.imgur.com/Hr0gG7C.png)

(2) When you are a beneficiary VASP, you need to configure the callbacks of this API (which callback_type is "POST_CDD") in order to obtain further required private information, which the originating VASP proactively sends right after the data transfer.

![](https://i.imgur.com/iabITEy.png)

(3) When you are a beneficiary VASP, you need to configure the callbacks of this API (which callback_type is "RESPOND_CDD") in order to obtain the follow-up enhanced CDD information from the originating VASP.

![](https://i.imgur.com/4cN7Kap.png)

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "2.0",
    "title": "Sygna Bridge API V2",
    "description": "Only for Sygna Bridge VASPs. For Sygna Hub VASPs, please refer to https://github.com/CoolBitX-Technology/sygna-hub-api-doc",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://test-api.sygna.io/v2",
      "description": "Bridge Sandbox server"
    },
    {
      "url": "https://{VASP-server}/v2",
      "description": "VASP Sandbox server"
    }
  ],
  "paths": {
    "/vasp/transaction/cdd": {
      "post": {
        "description": "This API may differ from your position as originating or beneficiary VASP:\n\n(1) When you are an originaing VASP, you need to configure the callbacks of this API (which callback_type is \"REQUEST_CDD\") in order to receive the CDD request from the beneficiary VASP.\n\n![](https://i.imgur.com/Hr0gG7C.png)\n\n(2) When you are a beneficiary VASP, you need to configure the callbacks of this API (which callback_type is \"POST_CDD\") in order to obtain further required private information, which the originating VASP proactively sends right after the data transfer.\n\n![](https://i.imgur.com/iabITEy.png)\n\n(3) When you are a beneficiary VASP, you need to configure the callbacks of this API (which callback_type is \"RESPOND_CDD\") in order to obtain the follow-up enhanced CDD information from the originating VASP.\n\n![](https://i.imgur.com/4cN7Kap.png)",
        "summary": "VASP/CDD",
        "tags": [
          "VASP API"
        ],
        "operationId": "VASP/CDD",
        "deprecated": false,
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "transfer_id": {
                    "$ref": "#/components/schemas/bridgeTransferID"
                  },
                  "callback_type": {
                    "$ref": "#/components/schemas/bridgeCDDCallbackType"
                  },
                  "request_cdd_data": {
                    "$ref": "#/components/schemas/bridgeRequestCddData"
                  },
                  "other_cdd_info": {
                    "type": "string",
                    "description": "ECIES encrypted [Other CDD Information] or Free-form text according to callback_type"
                  },
                  "signature": {
                    "$ref": "#/components/schemas/bridgeSignature"
                  }
                },
                "required": [
                  "transfer_id",
                  "callback_type",
                  "signature"
                ]
              },
              "examples": {
                "Originating VASP sends CDD information before requested by the beneficiary VASP": {
                  "value": {
                    "transfer_id": "ad468f326ebcc2242c32aa6bf7084c44135a068d939e52c08b6d2e86eb9ef725",
                    "other_cdd_info": "f4184fc596403b9d638783cf57adfe4c75c605f6356fbc91338530e9831e9e16",
                    "callback_type": "POST_CDD",
                    "signature": "6e8e259319f22df4dcb1a03cf701baf2d7fbd668fe3250f60ed12bb5c462fb712e9b68069ec0893042188a81a384da1fec5eb06173fadd327318db8430e606eb"
                  }
                },
                "Beneficiary VASP requests enhanced CDD information from the originating VASP": {
                  "value": {
                    "transfer_id": "ad468f326ebcc2242c32aa6bf7084c44135a068d939e52c08b6d2e86eb9ef725",
                    "request_cdd_data": {
                      "geographic_address": [
                        "town_name"
                      ],
                      "date_and_place_of_birth": [
                        "place_of_birth"
                      ]
                    },
                    "callback_type": "REQUEST_CDD",
                    "other_cdd_info": "[Passport Number]",
                    "signature": "6e8e259319f22df4dcb1a03cf701baf2d7fbd668fe3250f60ed12bb5c462fb712e9b68069ec0893042188a81a384da1fec5eb06173fadd327318db8430e606eb"
                  }
                },
                "Originating VASP sends CDD information after requested by the beneficiary VASP": {
                  "value": {
                    "transfer_id": "ad468f326ebcc2242c32aa6bf7084c44135a068d939e52c08b6d2e86eb9ef725",
                    "other_cdd_info": "f4184fc596403b9d638783cf57adfe4c75c605f6356fbc91338530e9831e9e16",
                    "callback_type": "RESPOND_CDD",
                    "signature": "6e8e259319f22df4dcb1a03cf701baf2d7fbd668fe3250f60ed12bb5c462fb712e9b68069ec0893042188a81a384da1fec5eb06173fadd327318db8430e606eb"
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/bridgeApiResponse"
                },
                "examples": {
                  "response": {
                    "value": {
                      "status": "OK"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "tags": [
    {
      "name": "VASP API"
    }
  ],
  "components": {
    "schemas": {
      "bridgeRequestCddData": {
        "title": "Request CDD Data",
        "type": "object",
        "properties": {
          "geographic_address": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "address_line",
                "address_type",
                "building_name",
                "building_number",
                "country",
                "country_sub_division",
                "department",
                "district_name",
                "floor",
                "post_box",
                "post_code",
                "room",
                "street_name",
                "sub_department",
                "town_location_name",
                "town_name"
              ]
            }
          },
          "national_identification": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "country_of_issue",
                "national_identifier",
                "national_identifier_type",
                "registration_authority"
              ]
            }
          },
          "date_and_place_of_birth": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "date_of_birth",
                "place_of_birth"
              ]
            }
          },
          "customer_identification": {
            "type": "boolean"
          },
          "country_of_residence": {
            "type": "boolean"
          },
          "other_cdd_info": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "bridgeSignature": {
        "title": "signature",
        "description": "Signature of the object that includes the constraint fields.",
        "type": "string",
        "minLength": 128,
        "maxLength": 128,
        "pattern": "^[0123456789A-Fa-f]+$"
      },
      "bridgeTransferID": {
        "title": "transfer_id",
        "description": "Unique Id generated by Bridge",
        "type": "string",
        "minLength": 64,
        "maxLength": 64
      },
      "bridgeApiResponse": {
        "title": "ApiResponse",
        "description": "Successful operation",
        "type": "object",
        "properties": {
          "status": {
            "type": "string"
          }
        },
        "required": [
          "status"
        ]
      },
      "bridgeCDDCallbackType": {
        "title": "CDDCallbackType",
        "description": "'POST_CDD' is used when the originating VASP sends the permission request along with the Customer Due Diligence (CDD) information before the beneficiary VASP requests it; 'REQUEST_CDD' is used when the beneficiary VASP requests the CDD information from the originating VASP; 'RESPOND_CDD' is used when the originating VASP sends the CDD information after the beneficiary VASP requests it.",
        "type": "string",
        "enum": [
          "REQUEST_CDD",
          "POST_CDD",
          "RESPOND_CDD"
        ]
      }
    }
  }
}
```