Generate UBO Doc
Needed for Business Users Only.
UBO or Ultimate Beneficial Owner documents is used to declare who is the ultimate beneficial owner of a business or major shareholder.
Please note that both POST and PATCH calls on the user document perform various asynchronous operations. So it's not recommended to make subsequent POST and then PATCH requests on the same user document as that can lead to various race conditions. We recommend submitting all documents at once vs performing subsequent operations on the same document.
patch
https://api.synapsefi.com
/v3.1/users/:user_id/ubo
UBO

Body Details

Key
Type
Required
Description
entity_info
Object
Yes
Information about the business. Go to Entity Info Details to learn more.
signer.document_id
String
Yes
Document ID of the base document of the signer.
signer.relationship_to_entity
String
Yes
Relationship of the signer with the entity. Eg. CEO, CRO, etc.
compliance_contact.document_id
String
Yes
Document ID of the base document of the compliance contact.
compliance_contact.relationship_to_entity
String
Yes
Relationship of the compliance contact with the entity. Eg. CEO, CCO, etc.
primary_controlling_contact.document_id
String
Yes
Document ID of the base document of the primary controlling contact.
primary_controlling_contact.relationship_to_entity
String
Yes
Relationship of the primary controlling contact with the entity. Eg. CEO, CCO, etc.
owners.document_id
String
Yes
Document ID of the base document of the owner.
owners.title
String
Yes
Relationship of the owner with the entity. Eg. CEO, CCO, etc.
owners.ownership
Number
Yes
Percentage ownership of the owner.

Entity Info Details

Key
Type
Required
Description
document_id
String
Yes
Document ID of the base document of the entity.
cryptocurrency
Boolean
Yes
Set as false if business is not involved with cryptocurrency.
msb.federal
Boolean
Yes
Set as false if business does not have Money Transmission Licenses (MTL) in any states.
msb.states
List of String
Yes
List of states that business has Money Transmission Licenses (MTL) in.
public_company
Boolean
Yes
Set as false if business is not a public company.
majority_owned_by_listed
String
Yes
Set as false if business is not majority owned (50% or more) by a public company.
registered_SEC
String
Yes
Set as false if business is not registered with U.S. Securities and Exchange Commission (SEC).
regulated_financial
String
Yes
Set as false if business is not a regulated financial company.
gambling
String
Yes
Set as false if business is not involved with the internet gambling business.

Example Request

HTTP
cURL
Python
JS
PHP
GO
1
PATCH /v3.1/users/5fd7acfd8677040053ad486d/ubo HTTP/1.1
2
Host: uat-api.synapsefi.com
3
X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_6zZVr8biuqGkyo9IxMO5jY2QlSp0nmD4EBAgKcJW
4
X-SP-USER-IP: 255.127.79.76
5
X-SP-USER: oauth_Z3YDaGPNz2CWpgVck8L9jIxKR7odTSui5eFEt10X|e83cf6ddcf778e37bfe3d48fc78a6502062fc
6
Content-Type: application/json
7
8
{
9
"entity_info": {
10
"cryptocurrency": true,
11
"msb": {
12
"federal": true,
13
"states": ["AL"]
14
},
15
"public_company": false,
16
"majority_owned_by_listed": false,
17
"registered_SEC": false,
18
"regulated_financial": false,
19
"gambling": false,
20
"document_id": "0162ac7bf11e873b33f3718c200999e341f6ff8e89482e8ed50e0d53a4d7cefa"
21
},
22
"signer": {
23
"document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
24
"relationship_to_entity": "CEO"
25
},
26
"compliance_contact": {
27
"document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
28
"relationship_to_entity": "CEO"
29
},
30
"primary_controlling_contact": {
31
"document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
32
"relationship_to_entity": "CEO"
33
},
34
"owners": [
35
{
36
"document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
37
"title": "CEO",
38
"ownership": 95
39
}
40
]
41
}
Copied!
1
curl --location --request PATCH 'https://uat-api.synapsefi.com/v3.1/users/5fd7acfd8677040053ad486d/ubo' \
2
--header 'X-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_6zZVr8biuqGkyo9IxMO5jY2QlSp0nmD4EBAgKcJW' \
3
--header 'X-SP-USER-IP: 255.127.79.76' \
4
--header 'X-SP-USER: oauth_Z3YDaGPNz2CWpgVck8L9jIxKR7odTSui5eFEt10X|e83cf6ddcf778e37bfe3d48fc78a6502062fc' \
5
--header 'Content-Type: application/json' \
6
--data-raw '{
7
"entity_info": {
8
"cryptocurrency": true,
9
"msb": {
10
"federal": true,
11
"states": ["AL"]
12
},
13
"public_company": false,
14
"majority_owned_by_listed": false,
15
"registered_SEC": false,
16
"regulated_financial": false,
17
"gambling": false,
18
"document_id": "0162ac7bf11e873b33f3718c200999e341f6ff8e89482e8ed50e0d53a4d7cefa"
19
},
20
"signer": {
21
"document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
22
"relationship_to_entity": "CEO"
23
},
24
"compliance_contact": {
25
"document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
26
"relationship_to_entity": "CEO"
27
},
28
"primary_controlling_contact": {
29
"document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
30
"relationship_to_entity": "CEO"
31
},
32
"owners": [
33
{
34
"document_id": "2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8",
35
"title": "CEO",
36
"ownership": 95
37
}
38
]
39
}'
Copied!
1
Copied!
1
Copied!
1
Copied!
1
Copied!
Last modified 1mo ago
Export as PDF
Copy link