Get Started
Customer
Customer Document
Go!Chat
Go!KYT
Go!Press
Go!Scan
Go!Vid
Appendix
Save customers
Updates or creates customers based on the input.
{
"customers": [
{
"account_type": "string",
"alias_ids": [
"string"
],
"comment": "string",
"company_name": "string",
"contacts": "any",
"date_of_birth": "string",
"disabled": "boolean",
"domicile_code": "string",
"domicile_codes": [
"string"
],
"external_id": "string",
"fields": "object",
"first_name": "string",
"kyc_level": "integer",
"kyc_level_requested": "integer",
"last_name": "string",
"middle_name": "string",
"nationality_code": "string",
"nationality_codes": [
"string"
],
"phone": "string",
"registration_number": "string",
"review_groups": "any",
"trading_name": "string",
"variations": [
{
"_op": "string",
"company_name": "string",
"first_name": "string",
"last_name": "string",
"middle_name": "string",
"trading_name": "string"
}
]
}
],
"disable_risk_scan": "boolean",
"relations": [
{
"child_customer_external_id": "string",
"disabled": "boolean",
"fields": "object",
"parent_customer_external_id": "string",
"relation_external_id": "string",
"relation_type": "integer"
}
],
"verify_input": "boolean"
}
{
"added": [
{
"customer_id": "string",
"external_id": "string"
}
],
"detail": [
{
"errors": [
{
"detail": "string",
"error": "string"
}
],
"external_id": "string",
"warnings": [
{
"detail": "string",
"error": "string"
}
]
}
],
"status": "string",
"verify_input": "boolean"
}
Body parameters
F (Firm) or N (Individual)
Same rules than review groups
Format YYYY-MM-DD
Unique to your business - mandatory field
Other fields (see custom fields in the backoffice); you must define custom field with your Algoreg representative, you will find the active custom fields in https://[domain].backoffice.algoreg.com/settings/import-setup
Either: a string separated by either ’;’ or ’,’ character. Ex: “A;B;C,D” an array of SaveCustomerDeltaArrayItemString
DO not execute scan and risk while importing; it will speedup the import but the risk and scan results will only be available on the next ongoing scan/risk process (usually over night). May be forced to true depending on how many customers are created/updated.
Target entity external ID
Other fields (see custom fields in the backoffice); you must define custom field with your Algoreg representative, you will find the active custom fields in https://[domain].backoffice.algoreg.com/settings/import-setup
Source entity external ID
Unique to your business
See RelationsTypes
True to just validate input without persisting data
Response body
{
"customers": [
{
"account_type": "string",
"alias_ids": [
"string"
],
"comment": "string",
"company_name": "string",
"contacts": "any",
"date_of_birth": "string",
"disabled": "boolean",
"domicile_code": "string",
"domicile_codes": [
"string"
],
"external_id": "string",
"fields": "object",
"first_name": "string",
"kyc_level": "integer",
"kyc_level_requested": "integer",
"last_name": "string",
"middle_name": "string",
"nationality_code": "string",
"nationality_codes": [
"string"
],
"phone": "string",
"registration_number": "string",
"review_groups": "any",
"trading_name": "string",
"variations": [
{
"_op": "string",
"company_name": "string",
"first_name": "string",
"last_name": "string",
"middle_name": "string",
"trading_name": "string"
}
]
}
],
"disable_risk_scan": "boolean",
"relations": [
{
"child_customer_external_id": "string",
"disabled": "boolean",
"fields": "object",
"parent_customer_external_id": "string",
"relation_external_id": "string",
"relation_type": "integer"
}
],
"verify_input": "boolean"
}
{
"added": [
{
"customer_id": "string",
"external_id": "string"
}
],
"detail": [
{
"errors": [
{
"detail": "string",
"error": "string"
}
],
"external_id": "string",
"warnings": [
{
"detail": "string",
"error": "string"
}
]
}
],
"status": "string",
"verify_input": "boolean"
}
{
"customers": [
{
"account_type": "string",
"alias_ids": [
"string"
],
"comment": "string",
"company_name": "string",
"contacts": "any",
"date_of_birth": "string",
"disabled": "boolean",
"domicile_code": "string",
"domicile_codes": [
"string"
],
"external_id": "string",
"fields": "object",
"first_name": "string",
"kyc_level": "integer",
"kyc_level_requested": "integer",
"last_name": "string",
"middle_name": "string",
"nationality_code": "string",
"nationality_codes": [
"string"
],
"phone": "string",
"registration_number": "string",
"review_groups": "any",
"trading_name": "string",
"variations": [
{
"_op": "string",
"company_name": "string",
"first_name": "string",
"last_name": "string",
"middle_name": "string",
"trading_name": "string"
}
]
}
],
"disable_risk_scan": "boolean",
"relations": [
{
"child_customer_external_id": "string",
"disabled": "boolean",
"fields": "object",
"parent_customer_external_id": "string",
"relation_external_id": "string",
"relation_type": "integer"
}
],
"verify_input": "boolean"
}
{
"added": [
{
"customer_id": "string",
"external_id": "string"
}
],
"detail": [
{
"errors": [
{
"detail": "string",
"error": "string"
}
],
"external_id": "string",
"warnings": [
{
"detail": "string",
"error": "string"
}
]
}
],
"status": "string",
"verify_input": "boolean"
}