Create
Request URL
POST /customer/init
Description
This endpoint initializes the creation of an individual or business customer. Creating a customer does not start a KYC/KYB (Know Your Customer/Business) process. It merely validates the data and registers a customer with connectFi.
The /customer/init endpoint supports idempotency and will not accept requests with duplicate reference IDs, SSN values (for individuals), or FEINs (for businesses). The SSN (for individuals)/FEIN (for businesses) included in the request body is how connectFi controls for duplicate customers. When initializing customers, do not reuse reference IDS, SSNs, or FEINs. Do not make more than one customer initialization request for a single individual or business. If customer details need to be updated after initialization, you must use the /customer/update endpoint.
There are two potential schema that will pass validation for the /customer/init endpoint. The first schema is for an individual customer and the second schema is for a business customer. The endpoint will check to make sure exactly one schema matches the given request. If neither schema passes validation, then the endpoint will return the issues that caused validation to fail (both for the individual customer schema and the business customer schema). Both schema are described below.
When initializing a business customer, if a unique ID is not provided for the business representative, then connectFi will generate a unique ID for the business representative entity automatically.
The format for the identification document object depends on the type of document. If the type of identification document is SSN, then the value of the SSN must be of type: "string" with pattern: "^[0-9]{9}$". Otherwise, the value will have the following schema: `{ type: "string", pattern: "^((?![<>]).)$", minLength: 0, maxLength: 50, nullable: true }`*
In order to create an individual customer that can be used to trigger a successful credit application check through an /ibis/credit-card/application request, the following values for customer.firstname, customer.lastName, and customer.identificationDocuments[#] should be included in the /ibis/customer/init request.
"customer.firstName": "JOLEEN",
"customer.lastName": "KAPSCH",
"customer.identificationDocuments": [
{
"type": "SSN",
"value": "666989698",
"issuanceCountryCodeA3": "USA"
}
]
Key for identificationDocument abbreviations
- 'SSN' - US SSN
- 'SIN' - Canada SIN
- 'NIN' - Other national ID
- 'TIN' - Taxpayer identification
- 'PASSPORT' - Any country, assume foreign
- 'DRIVING LICENSE' - For US only
- 'CONSULAR' - For foreign, consular ID
- 'VOTER' - US only, voter ID
- 'MILITARY ID' - Military ID, US only
- 'GOVERNMENT ISSUED ID' - Other Government-issued ID
Some examples of identificationDocument objects are:
"identificationDocuments": [
{
"type": "SSN",
"value": "123456789",
"issuanceCountryCodeA3": "USA"
},
{
"type": "DRIVING LICENSE",
"value": "PA1234567890123456", //driver license #
"issuanceCountryCodeA3": "USA",
"issuanceRegion": "PA",
"expiryDate": "2029-12-28"
},
{
"type": "PASSPORT",
"value": "123456789", //passport #
"issuanceCountryCodeA3": "ARE",
"issuanceRegion": "Dubai",
"expiryDate": "2029-12-28"
}
]
Schema
Property table for schema 1 for customer/init
| Property | Description | Required | Schema |
|---|---|---|---|
| customerReference | An external alphanumeric reference ID for the customer in your system | Yes | { "type": "string", "pattern": "^[0-9a-zA-Z]+$", "minLength": 1, "maxLength": 32, "description": "common-reference" } |
| customerType | Type of customer | Yes | { "type": "string", "enum": [ "individual" ] } |
| customer | Details of the customer | Yes | customer personal object |
Property table for schema 2 for customer/init
| Property | Description | Required | Schema |
|---|---|---|---|
| customerReference | An external alphanumeric reference ID for the customer in your system | Yes | { "type": "string", "pattern": "^[0-9a-zA-Z]+$", "minLength": 1, "maxLength": 32, "description": "common-reference" } |
| customerType | Type of customer | Yes | { "type": "string", "enum": [ "business" ] } |
| customer | Details of the customer | Yes | customer business object |
| businessRepresentatives | Details of the authorized businessRepresentative(s) | Yes | array of businessRepresentatives item objects |
Property table for addresses array item object
| Property | Description | Required | Schema |
|---|---|---|---|
| type | type | Yes | { "type": "string", "enum": [ "PRIMARY", "SECONDARY" ] } |
| addressLine1 | addressLine1 | Yes | { "type": "string", "pattern": "^((?![<>]).)*$", "minLength": 1, "maxLength": 50, "isNotOnlyWhitespace": true, "description": "common-commonStr50Req" } |
| addressLine2 | addressLine2 | No | { "type": "string", "pattern": "^((?![<>]).)*$", "minLength": 0, "maxLength": 50, "nullable": true, "description": "common-commonStr50" } |
| city | city | Yes | { "type": "string", "pattern": "^((?![<>]).)*$", "minLength": 1, "maxLength": 50, "isNotOnlyWhitespace": true, "description": "common-commonStr50Req" } |
| postalCode | postalCode | Yes | { "type": "string", "pattern": "^[0-9a-zA-Z-]+$", "minLength": 5, "maxLength": 10, "description": "customer-postalCode" } |
| stateCode | State abbreviation code | Yes | { "type": "string", "enum": [ "AL", "AK", "AS", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FM", "FL", "GA", "GU", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MH", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "MP", "OH", "OK", "OR", "PW", "PA", "PR", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VI", "VA", "WA", "WV", "WI", "WY" ], "description": "customer-stateCode" } |
| countryCodeA3 | 3-letter country code, ISO 3166-1 alpha-3 format | Yes | { "type": "string", "pattern": "^[A-Z]{3}$", "description": "customer-countryCodeA3" } |
Property table for businessAddresses array item object
| Property | Description | Required | Schema |
|---|---|---|---|
| type | type | Yes | { "type": "string", "enum": [ "PRIMARY", "SECONDARY" ] } |
| addressLine1 | addressLine1 | Yes | { "type": "string", "pattern": "^((?![<>]).)*$", "minLength": 1, "maxLength": 50, "isNotOnlyWhitespace": true, "description": "common-commonStr50Req" } |
| addressLine2 | addressLine2 | No | { "type": "string", "pattern": "^((?![<>]).)*$", "minLength": 0, "maxLength": 50, "nullable": true, "description": "common-commonStr50" } |
| city | city | Yes | { "type": "string", "pattern": "^((?![<>]).)*$", "minLength": 1, "maxLength": 50, "isNotOnlyWhitespace": true, "description": "common-commonStr50Req" } |
| postalCode | postalCode | Yes | { "type": "string", "pattern": "^[0-9a-zA-Z-]+$", "minLength": 5, "maxLength": 10, "description": "customer-postalCode" } |
| stateCode | State abbreviation code | Yes | { "type": "string", "enum": [ "AL", "AK", "AS", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FM", "FL", "GA", "GU", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MH", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "MP", "OH", "OK", "OR", "PW", "PA", "PR", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VI", "VA", "WA", "WV", "WI", "WY" ], "description": "customer-stateCode" } |
| countryCodeA3 | 3-letter country code, ISO 3166-1 alpha-3 format | Yes | { "type": "string", "pattern": "^[A-Z]{3}$", "description": "customer-countryCodeA3" } |
Property table for businessPhones array item object
| Property | Description | Required | Schema |
|---|---|---|---|
| type | type | Yes | { "type": "string", "enum": [ "MOBILE", "LANDLINE", "PRIMARY" ] } |
| phoneNumber | phoneNumber | Yes | { "type": "string", "pattern": "^\d+$", "minLength": 6, "maxLength": 12, "description": "customer-phoneNumber" } |
| countryDialingCode | Country dialing code prefix | No | { "type": "string", "pattern": "^\d+$", "minLength": 1, "maxLength": 4, "description": "customer-countryDialingCode" } |
Property table for businessRepresentatives array item object
| Property | Description | Required | Schema |
|---|---|---|---|
| firstName | First (given) name | Yes | { "type": "string", "pattern": "^((?![<>]).)*$", "minLength": 1, "maxLength": 50, "isNotOnlyWhitespace": true, "description": "common-commonStr50Req" } |
| lastName | Last (family) name | Yes | { "type": "string", "pattern": "^((?![<>]).)*$", "minLength": 1, "maxLength": 50, "isNotOnlyWhitespace": true, "description": "common-commonStr50Req" } |
| gender | gender | Yes | { "type": "string", "enum": [ "M", "F" ], "description": "customer-gender" } |
| dateOfBirth | Date of birth in YYYY-MM-DD format | Yes | { "type": "string", "format": "dateISO", "pattern": "^\d{4}-\d{2}-\d{2}$", "description": "common-dateOnly" } |
| Email address | Yes | { "type": "string", "format": "email", "description": "customer-email" } |
|
| addresses | Array of address objects | Yes | array of addresses item objects |
| citizenshipCountryCodeA3 | Country of citizenship as a 3-letter country code, ISO 3166-1 alpha-3 format | Yes | { "type": "string", "pattern": "^[A-Z]{3}$", "description": "customer-countryCodeA3" } |
| phones | Array of phone objects | Yes | array of phones item objects |
| identificationDocuments | Array of identification document objects | No | array of identificationDocuments item objects |
| id | id | No | { "type": "string", "pattern": "^[0-9a-zA-Z_]+$", "minLength": 1, "maxLength": 36, "description": "common-id" } |
| reference | An external alphanumeric reference ID for the entity in your system | No | { "type": "string", "pattern": "^[0-9a-zA-Z]+$", "minLength": 1, "maxLength": 32, "description": "common-reference" } |
| businessRepresentativeType | The type of business representative | No | { "type": "string", "enum": [ "principal_owner", "authorized_signer" ] } |
Property table for customer business object
| Property | Description | Required | Schema |
|---|---|---|---|
| businessName | The name of the business | Yes | { "type": "string", "pattern": "^((?![<>]).)*$", "minLength": 1, "maxLength": 50, "isNotOnlyWhitespace": true, "description": "common-commonStr50Req" } |
| businessFederalEin | The federal EIN of the business | Yes | { "type": "string", "pattern": "^[0-9]{9}$", "description": "customer-fein" } |
| businessAddresses | Array of address objects | Yes | array of businessAddresses item objects |
| businessPhones | Array of phone objects | Yes | array of businessPhones item objects |
Property table for customer personal object
| Property | Description | Required | Schema |
|---|---|---|---|
| firstName | First (given) name | Yes | { "type": "string", "pattern": "^((?![<>]).)*$", "minLength": 1, "maxLength": 50, "isNotOnlyWhitespace": true, "description": "common-commonStr50Req" } |
| lastName | Last (family) name | Yes | { "type": "string", "pattern": "^((?![<>]).)*$", "minLength": 1, "maxLength": 50, "isNotOnlyWhitespace": true, "description": "common-commonStr50Req" } |
| gender | gender | Yes | { "type": "string", "enum": [ "M", "F" ], "description": "customer-gender" } |
| dateOfBirth | Date of birth in YYYY-MM-DD format | Yes | { "type": "string", "format": "dateISO", "pattern": "^\d{4}-\d{2}-\d{2}$", "description": "common-dateOnly" } |
| Email address | Yes | { "type": "string", "format": "email", "description": "customer-email" } |
|
| addresses | Array of address objects | Yes | array of addresses item objects |
| citizenshipCountryCodeA3 | Country of citizenship as a 3-letter country code, ISO 3166-1 alpha-3 format | Yes | { "type": "string", "pattern": "^[A-Z]{3}$", "description": "customer-countryCodeA3" } |
| phones | Array of phone objects | Yes | array of phones item objects |
| identificationDocuments | Array of identification document objects | No | array of identificationDocuments item objects |
Property table for identificationDocuments array item object
| Property | Description | Required | Schema |
|---|---|---|---|
| type | type | No | { "type": "string", "enum": [ "SSN", "SIN", "NIN", "TIN", "PASSPORT", "DRIVING LICENSE", "CONSULAR", "VOTER", "MILITARY ID", "GOVERNMENT ISSUED ID" ], "description": "customer-identificationType" } |
| value | value | No | {} |
| issuanceCountryCodeA3 | 3-letter country code, ISO 3166-1 alpha-3 format | No | { "type": "string", "pattern": "^[A-Z]{3}$", "nullable": true } |
| issuanceRegion | The region in which the identification document was issued | No | { "type": "string", "pattern": "^((?![<>]).)*$", "minLength": 0, "maxLength": 50, "nullable": true, "description": "common-commonStr50" } |
| expiryDate | The expiration date | No | { "type": "string", "format": "dateISO", "pattern": "^\d{4}-\d{2}-\d{2}$", "description": "common-dateOnly" } |
Property table for phones array item object
| Property | Description | Required | Schema |
|---|---|---|---|
| type | type | Yes | { "type": "string", "enum": [ "MOBILE", "LANDLINE", "PRIMARY" ] } |
| phoneNumber | phoneNumber | Yes | { "type": "string", "pattern": "^\d+$", "minLength": 6, "maxLength": 12, "description": "customer-phoneNumber" } |
| countryDialingCode | Country dialing code prefix | No | { "type": "string", "pattern": "^\d+$", "minLength": 1, "maxLength": 4, "description": "customer-countryDialingCode" } |
Request Body
{
"customerReference": "ExtRefICust104",
"customerType": "individual",
"customer": {
"firstName": "JOLEEN",
"lastName": "KAPSCH",
"gender": "F",
"email": "aa@aa.aa",
"phones": [
{
"type": "MOBILE",
"countryDialingCode": "01",
"phoneNumber": "5556667777"
}
],
"dateOfBirth": "1969-08-04",
"citizenshipCountryCodeA3": "USA",
"addresses": [
{
"type": "PRIMARY",
"addressLine1": "123 Main Str.",
"addressLine2": "apt 1",
"city": "Harrisburg",
"stateCode": "PA",
"postalCode": "12345",
"countryCodeA3": "USA"
}
],
"identificationDocuments": [
{
"type": "SSN",
"value": "666989698",
"issuanceCountryCodeA3": "USA"
},
{
"type": "DRIVING LICENSE",
"value": "PA99999999",
"issuanceCountryCodeA3": "USA",
"issuanceRegion": "PA",
"expiryDate": "2029-12-28"
}
]
}
}
Snippet Examples
javascript
const axios = require('axios');
const data = {
"customerReference": "ExtRefICust104",
"customerType": "individual",
"customer": {
"firstName": "JOLEEN",
"lastName": "KAPSCH",
"gender": "F",
"email": "aa@aa.aa",
"phones": [
{
"type": "MOBILE",
"countryDialingCode": "01",
"phoneNumber": "5556667777"
}
],
"dateOfBirth": "1969-08-04",
"citizenshipCountryCodeA3": "USA",
"addresses": [
{
"type": "PRIMARY",
"addressLine1": "123 Main Str.",
"addressLine2": "apt 1",
"city": "Harrisburg",
"stateCode": "PA",
"postalCode": "12345",
"countryCodeA3": "USA"
}
],
"identificationDocuments": [
{
"type": "SSN",
"value": "666989698",
"issuanceCountryCodeA3": "USA"
},
{
"type": "DRIVING LICENSE",
"value": "PA99999999",
"issuanceCountryCodeA3": "USA",
"issuanceRegion": "PA",
"expiryDate": "2029-12-28"
}
]
}
};
const config = {
method: 'POST',
url: '${CONNECTFI_BASE_URL}/customer/init',
headers: {
'Content-Type': "application/json",
'x-connectfi-token': "A long random string token received from /auth/get-token request"
},
data
};
let result;
try {
result = await axios.request(config);
if (result.status === 200) {
console.log(JSON.stringify(result.data));
}
} catch (err) {
console.log({
errCode: err.code,
responseStatus: err.response && err.response.status,
data: err.response && JSON.stringify(err.response.data)
});
}
cURL
curl --location "CONNECTFI_BASE_URL/customer/init" --data "{\"customerReference\":\"ExtRefICust104\",\"customerType\":\"individual\",\"customer\":{\"firstName\":\"JOLEEN\",\"lastName\":\"KAPSCH\",\"gender\":\"F\",\"email\":\"aa@aa.aa\", \"phones\":[{\"type\":\"MOBILE\",\"countryDialingCode\":\"01\",\"phoneNumber\":\"5556667777\"}],\"dateOfBirth\":\"1969-08-04\",\"citizenshipCountryCodeA3\":\"USA\",\"addresses\":[{\"type\":\"PRIMARY\",\"addressLine1\":\"123 Main Str.\",\"addressLine2\":\"apt 1\",\"city\":\"Harrisburg\",\"stateCode\":\"PA\",\"postalCode\":\"12345\",\"countryCodeA3\":\"USA\"}],\"identificationDocuments\":[{\"type\":\"SSN\",\"value\":\"666989698\",\"issuanceCountryCodeA3\":\"USA\"},{\"type\":\"DRIVING LICENSE\",\"value\":\"PA99999999\",\"issuanceCountryCodeA3\":\"USA\",\"issuanceRegion\":\"PA\", \"expiryDate\":\"2029-12-28\"}]}}" --header "Content-Type: application/json" --header "x-connectfi-token: A long random string token received from /auth/get-token request"
Successful Response Examples
200 SUCCESSFUL RESPONSE FOR INDIVIDUAL CUSTOMER
HEADERS
| Header | Value |
|---|---|
| Content-Type | application/json |
| x-connectfi-token | A long random string token received from /auth/get-token request |
REQUEST BODY
{
"customerReference": "ExtRefICust101",
"customerType": "individual",
"customer": {
"firstName": "Janice",
"lastName": "Sample",
"gender": "M",
"email": "aa@aa.aa",
"phones": [
{
"type": "MOBILE",
"countryDialingCode": "01",
"phoneNumber": "5556667777"
}
],
"dateOfBirth": "1969-08-04",
"citizenshipCountryCodeA3": "USA",
"addresses": [
{
"type": "PRIMARY",
"addressLine1": "123 Main Str.",
"addressLine2": "apt 1",
"city": "Harrisburg",
"stateCode": "PA",
"postalCode": "12345",
"countryCodeA3": "USA"
}
],
"identificationDocuments": [
{
"type": "SSN",
"value": "666989698",
"issuanceCountryCodeA3": "USA"
},
{
"type": "DRIVING LICENSE",
"value": "PA99999999",
"issuanceCountryCodeA3": "USA",
"issuanceRegion": "PA",
"expiryDate": "2029-12-28"
}
]
}
}
RESPONSE BODY
{
"code": "0",
"data": {
"reference": "ExtRefICust101",
"customerId": "cstap_6reGTr3k8vpAu8uFV7EdiN",
"customerType": "individual",
"customer": {
"firstName": "Janice",
"lastName": "Sample",
"gender": "M",
"dateOfBirth": "1969-08-04",
"email": "aa@aa.aa",
"citizenshipCountryCodeA3": "USA",
"addresses": [
{
"type": "PRIMARY",
"addressLine1": "123 Main Str.",
"addressLine2": "apt 1",
"city": "Harrisburg",
"countryCodeA3": "USA",
"postalCode": "12345",
"stateCode": "PA"
}
],
"phones": [
{
"type": "MOBILE",
"phoneNumber": "5556667777",
"countryDialingCode": "01"
}
],
"identificationDocuments": [
{
"type": "SSN",
"issuanceCountryCodeA3": "USA",
"last4": "9698"
},
{
"type": "DRIVING LICENSE",
"value": "PA99999999",
"issuanceCountryCodeA3": "USA",
"issuanceRegion": "PA",
"expiryDate": "2029-12-28"
}
]
},
"boises": [],
"dtsCreatedAt": "2023-11-01T16:07:59.332Z"
},
"requestId": "d38a973078d011eeb5658f28ab5fe311"
}
200 SUCCESSFUL RESPONSE FOR BUSINESS CUSTOMER
HEADERS
| Header | Value |
|---|---|
| Content-Type | application/json |
| x-connectfi-token | A long random string token received from /auth/get-token request |
REQUEST BODY
{
"customerReference": "ExtRefBCust100",
"customerType": "business",
"customer": {
"businessName": "AWSM BRAND MANAGEMENT INC",
"businessFederalEin": "123456789",
"businessPhones": [
{
"type": "PRIMARY",
"countryDialingCode": "01",
"phoneNumber": "5556667777"
}
],
"businessAddresses": [
{
"type": "PRIMARY",
"addressLine1": "123 Main Str.",
"addressLine2": "apt 7",
"city": "Harrisburg",
"stateCode": "PA",
"postalCode": "12345",
"countryCodeA3": "USA"
}
]
},
"businessRepresentatives" : [
{
"firstName": "JOLEEN",
"lastName": "KAPSCH",
"gender": "F",
"businessRepresentativeType" : "principal_owner",
"email": "aa@aa.aa",
"phones": [
{
"type": "MOBILE",
"countryDialingCode": "01",
"phoneNumber": "5556667777"
}
],
"dateOfBirth": "1978-10-15",
"citizenshipCountryCodeA3": "USA",
"addresses": [
{
"type": "PRIMARY",
"addressLine1": "123 Main Str.",
"addressLine2": "apt 7",
"city": "Harrisburg",
"stateCode": "PA",
"postalCode": "12345",
"countryCodeA3": "USA"
}
],
"identificationDocuments": [
{
"type": "SSN",
"value": "666989698",
"issuanceCountryCodeA3": "USA"
},
{
"type": "DRIVING LICENSE",
"value": "PA1234567890123456",
"issuanceCountryCodeA3": "USA",
"issuanceRegion": "PA",
"expiryDate": "2029-12-28"
}
]
}
]
}
RESPONSE BODY
{
"code": "0",
"data": {
"reference": "ExtRefBCust100",
"customerId": "cstab_7BX5DO49J48VeWKsJ6gWNb",
"customerType": "business",
"customer": {
"businessName": "AWSM BRAND MANAGEMENT INC",
"businessFederalEin": "123456789",
"businessAddresses": [
{
"type": "PRIMARY",
"addressLine1": "123 Main Str.",
"addressLine2": "apt 7",
"city": "Harrisburg",
"countryCodeA3": "USA",
"postalCode": "12345",
"stateCode": "PA"
}
],
"businessPhones": [
{
"type": "PRIMARY",
"phoneNumber": "5556667777",
"countryDialingCode": "01"
}
]
},
"boises": [],
"dtsCreatedAt": "2023-11-01T17:13:29.457Z",
"businessRepresentatives": [
{
"id": "cstab_7BX5DPJcbmipymiokecA6d",
"firstName": "JOLEEN",
"lastName": "KAPSCH",
"gender": "F",
"dateOfBirth": "1978-10-15T00:00:00.000Z",
"businessRepresentativeType": "principal_owner",
"email": "aa@aa.aa",
"citizenshipCountryCodeA3": "USA",
"addresses": [
{
"type": "PRIMARY",
"addressLine1": "123 Main Str.",
"addressLine2": "apt 7",
"city": "Harrisburg",
"countryCodeA3": "USA",
"postalCode": "12345",
"stateCode": "PA"
}
],
"phones": [
{
"type": "MOBILE",
"phoneNumber": "5556667777",
"countryDialingCode": "01"
}
],
"identificationDocuments": [
{
"type": "SSN",
"value": "666989698",
"issuanceCountryCodeA3": "USA"
},
{
"type": "DRIVING LICENSE",
"value": "PA1234567890123456",
"issuanceCountryCodeA3": "USA",
"issuanceRegion": "PA",
"expiryDate": "2029-12-28"
}
]
}
]
},
"requestId": "f9f407e078d911eeb5658f28ab5fe311"
}
200 SUCCESSFUL RESPONSE FOR BUSINESS CUSTOMER 2
HEADERS
| Header | Value |
|---|---|
| Content-Type | application/json |
| x-connectfi-token | A long random string token received from /auth/get-token request |
REQUEST BODY
{
"customerReference": "ExtRefBCust102",
"customerType": "business",
"customer": {
"businessName": "ABC BRAND MANAGEMENT INC",
"businessFederalEin": "123456789",
"businessPhones": [
{
"type": "PRIMARY",
"countryDialingCode": "01",
"phoneNumber": "5556667777"
}
],
"businessAddresses": [
{
"type": "PRIMARY",
"addressLine1": "456 Main Str.",
"addressLine2": "apt 7",
"city": "Harrisburg",
"stateCode": "PA",
"postalCode": "12345",
"countryCodeA3": "USA"
}
]
},
"businessRepresentatives" : [
{
"firstName": "John",
"lastName": "Doe",
"gender": "M",
"businessRepresentativeType" : "principal_owner",
"email": "j_doe@test.test",
"phones": [
{
"type": "MOBILE",
"countryDialingCode": "01",
"phoneNumber": "5556667777"
}
],
"dateOfBirth": "1977-09-20",
"citizenshipCountryCodeA3": "USA",
"addresses": [
{
"type": "PRIMARY",
"addressLine1": "123 Main Str.",
"addressLine2": "apt 7",
"city": "Harrisburg",
"stateCode": "PA",
"postalCode": "12345",
"countryCodeA3": "USA"
}
]
}
]
}
RESPONSE BODY
{
"code": "0",
"data": {
"reference": "ExtRefBCust102",
"customerId": "cstab_3r7YqLljc9H24tOlp4Qht7",
"customerType": "business",
"customer": {
"businessName": "ABC BRAND MANAGEMENT INC",
"businessFederalEin": "123456789",
"businessAddresses": [
{
"type": "PRIMARY",
"addressLine1": "456 Main Str.",
"addressLine2": "apt 7",
"city": "Harrisburg",
"countryCodeA3": "USA",
"postalCode": "12345",
"stateCode": "PA"
}
],
"businessPhones": [
{
"type": "PRIMARY",
"phoneNumber": "5556667777",
"countryDialingCode": "01"
}
]
},
"boises": [],
"dtsCreatedAt": "2023-11-01T17:16:48.823Z",
"businessRepresentatives": [
{
"id": "cstab_3r7YqN0lErQwnTmh0cLUM9",
"firstName": "John",
"lastName": "Doe",
"gender": "M",
"dateOfBirth": "1977-09-20T00:00:00.000Z",
"businessRepresentativeType": "principal_owner",
"email": "j_doe@test.test",
"citizenshipCountryCodeA3": "USA",
"addresses": [
{
"type": "PRIMARY",
"addressLine1": "123 Main Str.",
"addressLine2": "apt 7",
"city": "Harrisburg",
"countryCodeA3": "USA",
"postalCode": "12345",
"stateCode": "PA"
}
],
"phones": [
{
"type": "MOBILE",
"phoneNumber": "5556667777",
"countryDialingCode": "01"
}
],
"identificationDocuments": []
}
]
},
"requestId": "70e8e96078da11eeb5658f28ab5fe311"
}