Create a business
curl --request POST \
--url https://api-sandbox.synctera.com/v0/businesses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"is_customer": true,
"compliance_restrictions": [
"LICENSED_CANNABIS"
],
"ein": "12-3456789",
"email": "alice@example.com",
"entity_name": "Apex Corporation",
"formation_date": "2000-01-01",
"formation_state": "NY",
"metadata": {},
"phone_number": "+14374570680",
"spend_control_ids": [
"7d943c51-e4ff-4e57-9558-08cab6b963c7"
],
"structure": "CORPORATION",
"tenant": "abcdef_ghijkl",
"trade_names": [
"Apex",
"Apex LLC",
"CorporationID#77231"
],
"website": "https://example.com"
}
'import requests
url = "https://api-sandbox.synctera.com/v0/businesses"
payload = {
"is_customer": True,
"compliance_restrictions": ["LICENSED_CANNABIS"],
"ein": "12-3456789",
"email": "alice@example.com",
"entity_name": "Apex Corporation",
"formation_date": "2000-01-01",
"formation_state": "NY",
"metadata": {},
"phone_number": "+14374570680",
"spend_control_ids": ["7d943c51-e4ff-4e57-9558-08cab6b963c7"],
"structure": "CORPORATION",
"tenant": "abcdef_ghijkl",
"trade_names": ["Apex", "Apex LLC", "CorporationID#77231"],
"website": "https://example.com"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
is_customer: true,
compliance_restrictions: ['LICENSED_CANNABIS'],
ein: '12-3456789',
email: 'alice@example.com',
entity_name: 'Apex Corporation',
formation_date: '2000-01-01',
formation_state: 'NY',
metadata: {},
phone_number: '+14374570680',
spend_control_ids: ['7d943c51-e4ff-4e57-9558-08cab6b963c7'],
structure: 'CORPORATION',
tenant: 'abcdef_ghijkl',
trade_names: ['Apex', 'Apex LLC', 'CorporationID#77231'],
website: 'https://example.com'
})
};
fetch('https://api-sandbox.synctera.com/v0/businesses', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-sandbox.synctera.com/v0/businesses",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'is_customer' => true,
'compliance_restrictions' => [
'LICENSED_CANNABIS'
],
'ein' => '12-3456789',
'email' => 'alice@example.com',
'entity_name' => 'Apex Corporation',
'formation_date' => '2000-01-01',
'formation_state' => 'NY',
'metadata' => [
],
'phone_number' => '+14374570680',
'spend_control_ids' => [
'7d943c51-e4ff-4e57-9558-08cab6b963c7'
],
'structure' => 'CORPORATION',
'tenant' => 'abcdef_ghijkl',
'trade_names' => [
'Apex',
'Apex LLC',
'CorporationID#77231'
],
'website' => 'https://example.com'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api-sandbox.synctera.com/v0/businesses"
payload := strings.NewReader("{\n \"is_customer\": true,\n \"compliance_restrictions\": [\n \"LICENSED_CANNABIS\"\n ],\n \"ein\": \"12-3456789\",\n \"email\": \"alice@example.com\",\n \"entity_name\": \"Apex Corporation\",\n \"formation_date\": \"2000-01-01\",\n \"formation_state\": \"NY\",\n \"metadata\": {},\n \"phone_number\": \"+14374570680\",\n \"spend_control_ids\": [\n \"7d943c51-e4ff-4e57-9558-08cab6b963c7\"\n ],\n \"structure\": \"CORPORATION\",\n \"tenant\": \"abcdef_ghijkl\",\n \"trade_names\": [\n \"Apex\",\n \"Apex LLC\",\n \"CorporationID#77231\"\n ],\n \"website\": \"https://example.com\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api-sandbox.synctera.com/v0/businesses")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"is_customer\": true,\n \"compliance_restrictions\": [\n \"LICENSED_CANNABIS\"\n ],\n \"ein\": \"12-3456789\",\n \"email\": \"alice@example.com\",\n \"entity_name\": \"Apex Corporation\",\n \"formation_date\": \"2000-01-01\",\n \"formation_state\": \"NY\",\n \"metadata\": {},\n \"phone_number\": \"+14374570680\",\n \"spend_control_ids\": [\n \"7d943c51-e4ff-4e57-9558-08cab6b963c7\"\n ],\n \"structure\": \"CORPORATION\",\n \"tenant\": \"abcdef_ghijkl\",\n \"trade_names\": [\n \"Apex\",\n \"Apex LLC\",\n \"CorporationID#77231\"\n ],\n \"website\": \"https://example.com\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.synctera.com/v0/businesses")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"is_customer\": true,\n \"compliance_restrictions\": [\n \"LICENSED_CANNABIS\"\n ],\n \"ein\": \"12-3456789\",\n \"email\": \"alice@example.com\",\n \"entity_name\": \"Apex Corporation\",\n \"formation_date\": \"2000-01-01\",\n \"formation_state\": \"NY\",\n \"metadata\": {},\n \"phone_number\": \"+14374570680\",\n \"spend_control_ids\": [\n \"7d943c51-e4ff-4e57-9558-08cab6b963c7\"\n ],\n \"structure\": \"CORPORATION\",\n \"tenant\": \"abcdef_ghijkl\",\n \"trade_names\": [\n \"Apex\",\n \"Apex LLC\",\n \"CorporationID#77231\"\n ],\n \"website\": \"https://example.com\"\n}"
response = http.request(request)
puts response.read_body{
"is_customer": true,
"status": "ACTIVE",
"addresses": [
{
"address_line_1": "100 Main St.",
"country_code": "US",
"address_line_2": "Suite 99",
"address_type": "SHIPPING",
"city": "New York",
"id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
"is_registered_agent": true,
"nickname": "Home",
"postal_code": "28620",
"state": "NY"
}
],
"classifications": [
"AUTHORIZED_USER"
],
"compliance_restrictions": [
"LICENSED_CANNABIS"
],
"creation_time": "2010-05-06T12:23:34.321Z",
"customer_active": "2010-05-06T12:23:34.321Z",
"ein": "12-3456789",
"email": "alice@example.com",
"entity_name": "Apex Corporation",
"formation_date": "2000-01-01",
"formation_state": "NY",
"has_accounts": true,
"id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
"last_updated_time": "2010-05-06T12:23:34.321Z",
"legal_address": {
"address_line_1": "100 Main St.",
"country_code": "US",
"address_line_2": "Suite 99",
"address_type": "SHIPPING",
"city": "New York",
"id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
"is_registered_agent": true,
"nickname": "Home",
"postal_code": "28620",
"state": "NY"
},
"metadata": {},
"phone_number": "+14374570680",
"spend_control_ids": [
"7d943c51-e4ff-4e57-9558-08cab6b963c7"
],
"structure": "CORPORATION",
"tenant": "abcdef_ghijkl",
"trade_names": [
"Apex",
"Apex LLC",
"CorporationID#77231"
],
"verification_last_run": "2010-05-06T12:23:34.321Z",
"verification_status": "ACCEPTED",
"website": "https://example.com",
"vendor_info": {
"vendor_data": {
"loanpro": {
"customer_id": 12345
}
},
"vendor_type": "LOANPRO"
}
}{
"code": "BAD_REQUEST_BODY",
"detail": "missing required fields: first_name, dob",
"status": 400,
"title": "Bad Request Body",
"type": "https://dev.synctera.com/errors/bad-request-body"
}{
"code": "BAD_REQUEST_BODY",
"detail": "missing required fields: first_name, dob",
"status": 400,
"title": "Bad Request Body",
"type": "https://dev.synctera.com/errors/bad-request-body"
}{
"code": "BAD_REQUEST_BODY",
"detail": "missing required fields: first_name, dob",
"status": 400,
"title": "Bad Request Body",
"type": "https://dev.synctera.com/errors/bad-request-body"
}{
"code": "BAD_REQUEST_BODY",
"detail": "missing required fields: first_name, dob",
"status": 400,
"title": "Bad Request Body",
"type": "https://dev.synctera.com/errors/bad-request-body"
}{
"code": "BAD_REQUEST_BODY",
"detail": "missing required fields: first_name, dob",
"status": 400,
"title": "Bad Request Body",
"type": "https://dev.synctera.com/errors/bad-request-body"
}Businesses
Create a business
Create a business who may act as a customer or a related business. You can then verify the identity of this customer and associate them with other people and accounts.
POST
/
businesses
Create a business
curl --request POST \
--url https://api-sandbox.synctera.com/v0/businesses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"is_customer": true,
"compliance_restrictions": [
"LICENSED_CANNABIS"
],
"ein": "12-3456789",
"email": "alice@example.com",
"entity_name": "Apex Corporation",
"formation_date": "2000-01-01",
"formation_state": "NY",
"metadata": {},
"phone_number": "+14374570680",
"spend_control_ids": [
"7d943c51-e4ff-4e57-9558-08cab6b963c7"
],
"structure": "CORPORATION",
"tenant": "abcdef_ghijkl",
"trade_names": [
"Apex",
"Apex LLC",
"CorporationID#77231"
],
"website": "https://example.com"
}
'import requests
url = "https://api-sandbox.synctera.com/v0/businesses"
payload = {
"is_customer": True,
"compliance_restrictions": ["LICENSED_CANNABIS"],
"ein": "12-3456789",
"email": "alice@example.com",
"entity_name": "Apex Corporation",
"formation_date": "2000-01-01",
"formation_state": "NY",
"metadata": {},
"phone_number": "+14374570680",
"spend_control_ids": ["7d943c51-e4ff-4e57-9558-08cab6b963c7"],
"structure": "CORPORATION",
"tenant": "abcdef_ghijkl",
"trade_names": ["Apex", "Apex LLC", "CorporationID#77231"],
"website": "https://example.com"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
is_customer: true,
compliance_restrictions: ['LICENSED_CANNABIS'],
ein: '12-3456789',
email: 'alice@example.com',
entity_name: 'Apex Corporation',
formation_date: '2000-01-01',
formation_state: 'NY',
metadata: {},
phone_number: '+14374570680',
spend_control_ids: ['7d943c51-e4ff-4e57-9558-08cab6b963c7'],
structure: 'CORPORATION',
tenant: 'abcdef_ghijkl',
trade_names: ['Apex', 'Apex LLC', 'CorporationID#77231'],
website: 'https://example.com'
})
};
fetch('https://api-sandbox.synctera.com/v0/businesses', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-sandbox.synctera.com/v0/businesses",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'is_customer' => true,
'compliance_restrictions' => [
'LICENSED_CANNABIS'
],
'ein' => '12-3456789',
'email' => 'alice@example.com',
'entity_name' => 'Apex Corporation',
'formation_date' => '2000-01-01',
'formation_state' => 'NY',
'metadata' => [
],
'phone_number' => '+14374570680',
'spend_control_ids' => [
'7d943c51-e4ff-4e57-9558-08cab6b963c7'
],
'structure' => 'CORPORATION',
'tenant' => 'abcdef_ghijkl',
'trade_names' => [
'Apex',
'Apex LLC',
'CorporationID#77231'
],
'website' => 'https://example.com'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api-sandbox.synctera.com/v0/businesses"
payload := strings.NewReader("{\n \"is_customer\": true,\n \"compliance_restrictions\": [\n \"LICENSED_CANNABIS\"\n ],\n \"ein\": \"12-3456789\",\n \"email\": \"alice@example.com\",\n \"entity_name\": \"Apex Corporation\",\n \"formation_date\": \"2000-01-01\",\n \"formation_state\": \"NY\",\n \"metadata\": {},\n \"phone_number\": \"+14374570680\",\n \"spend_control_ids\": [\n \"7d943c51-e4ff-4e57-9558-08cab6b963c7\"\n ],\n \"structure\": \"CORPORATION\",\n \"tenant\": \"abcdef_ghijkl\",\n \"trade_names\": [\n \"Apex\",\n \"Apex LLC\",\n \"CorporationID#77231\"\n ],\n \"website\": \"https://example.com\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api-sandbox.synctera.com/v0/businesses")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"is_customer\": true,\n \"compliance_restrictions\": [\n \"LICENSED_CANNABIS\"\n ],\n \"ein\": \"12-3456789\",\n \"email\": \"alice@example.com\",\n \"entity_name\": \"Apex Corporation\",\n \"formation_date\": \"2000-01-01\",\n \"formation_state\": \"NY\",\n \"metadata\": {},\n \"phone_number\": \"+14374570680\",\n \"spend_control_ids\": [\n \"7d943c51-e4ff-4e57-9558-08cab6b963c7\"\n ],\n \"structure\": \"CORPORATION\",\n \"tenant\": \"abcdef_ghijkl\",\n \"trade_names\": [\n \"Apex\",\n \"Apex LLC\",\n \"CorporationID#77231\"\n ],\n \"website\": \"https://example.com\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.synctera.com/v0/businesses")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"is_customer\": true,\n \"compliance_restrictions\": [\n \"LICENSED_CANNABIS\"\n ],\n \"ein\": \"12-3456789\",\n \"email\": \"alice@example.com\",\n \"entity_name\": \"Apex Corporation\",\n \"formation_date\": \"2000-01-01\",\n \"formation_state\": \"NY\",\n \"metadata\": {},\n \"phone_number\": \"+14374570680\",\n \"spend_control_ids\": [\n \"7d943c51-e4ff-4e57-9558-08cab6b963c7\"\n ],\n \"structure\": \"CORPORATION\",\n \"tenant\": \"abcdef_ghijkl\",\n \"trade_names\": [\n \"Apex\",\n \"Apex LLC\",\n \"CorporationID#77231\"\n ],\n \"website\": \"https://example.com\"\n}"
response = http.request(request)
puts response.read_body{
"is_customer": true,
"status": "ACTIVE",
"addresses": [
{
"address_line_1": "100 Main St.",
"country_code": "US",
"address_line_2": "Suite 99",
"address_type": "SHIPPING",
"city": "New York",
"id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
"is_registered_agent": true,
"nickname": "Home",
"postal_code": "28620",
"state": "NY"
}
],
"classifications": [
"AUTHORIZED_USER"
],
"compliance_restrictions": [
"LICENSED_CANNABIS"
],
"creation_time": "2010-05-06T12:23:34.321Z",
"customer_active": "2010-05-06T12:23:34.321Z",
"ein": "12-3456789",
"email": "alice@example.com",
"entity_name": "Apex Corporation",
"formation_date": "2000-01-01",
"formation_state": "NY",
"has_accounts": true,
"id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
"last_updated_time": "2010-05-06T12:23:34.321Z",
"legal_address": {
"address_line_1": "100 Main St.",
"country_code": "US",
"address_line_2": "Suite 99",
"address_type": "SHIPPING",
"city": "New York",
"id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
"is_registered_agent": true,
"nickname": "Home",
"postal_code": "28620",
"state": "NY"
},
"metadata": {},
"phone_number": "+14374570680",
"spend_control_ids": [
"7d943c51-e4ff-4e57-9558-08cab6b963c7"
],
"structure": "CORPORATION",
"tenant": "abcdef_ghijkl",
"trade_names": [
"Apex",
"Apex LLC",
"CorporationID#77231"
],
"verification_last_run": "2010-05-06T12:23:34.321Z",
"verification_status": "ACCEPTED",
"website": "https://example.com",
"vendor_info": {
"vendor_data": {
"loanpro": {
"customer_id": 12345
}
},
"vendor_type": "LOANPRO"
}
}{
"code": "BAD_REQUEST_BODY",
"detail": "missing required fields: first_name, dob",
"status": 400,
"title": "Bad Request Body",
"type": "https://dev.synctera.com/errors/bad-request-body"
}{
"code": "BAD_REQUEST_BODY",
"detail": "missing required fields: first_name, dob",
"status": 400,
"title": "Bad Request Body",
"type": "https://dev.synctera.com/errors/bad-request-body"
}{
"code": "BAD_REQUEST_BODY",
"detail": "missing required fields: first_name, dob",
"status": 400,
"title": "Bad Request Body",
"type": "https://dev.synctera.com/errors/bad-request-body"
}{
"code": "BAD_REQUEST_BODY",
"detail": "missing required fields: first_name, dob",
"status": 400,
"title": "Bad Request Body",
"type": "https://dev.synctera.com/errors/bad-request-body"
}{
"code": "BAD_REQUEST_BODY",
"detail": "missing required fields: first_name, dob",
"status": 400,
"title": "Bad Request Body",
"type": "https://dev.synctera.com/errors/bad-request-body"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry.
Example:
"7d943c51-e4ff-4e57-9558-08cab6b963c7"
Body
application/json
Represents a business customer.
True for personal and business customers with a direct relationship with the fintech or bank. Set this to true for any customer related to an account.
Example:
true
Status of the business. One of the following:
PROSPECT– a potential customer, used for information-gathering and disclosures.ACTIVE– is an integrator defined status. Integrators should set a business to active if they believe the person to be qualified for conducting business. Synctera will combine this status with other statuses such a verification to determine if the business is eligible for specific actions such as initiating transactions or issuing a card.FROZEN– business's actions are blocked for security, legal, or other reasons.SANCTION– business is on a sanctions list and should be carefully monitored.DISSOLVED– an inactive status indicating a business entity has filed articles of dissolution or a certificate of termination to terminate its existence.CANCELLED– an inactive status indicating that a business entity has filed a cancellation or has failed to file its periodic report after notice of forfeiture of its rights to do business.SUSPENDED– an inactive status indicating that the business entity has lost the right to operate in it's registered jurisdiction.MERGED– an inactive status indicating that the business entity has terminated existence by merging into another entity.INACTIVE– an inactive status indicating that the business entity is no longer active.CONVERTED– An inactive status indicating that the business entity has been converted to another type of business entity in the same jurisdiction.
Available options:
ACTIVE, CANCELLED, CONVERTED, DISSOLVED, FROZEN, INACTIVE, MERGED, PROSPECT, SANCTION, SUSPENDED The types of compliance that the business needs to adhere to
LICENSED_CANNABIS– A type of compliance restriction where the business would need a cannabis license in order to operate.
Available options:
LICENSED_CANNABIS U.S. Employer Identification Number (EIN) for this business, in the format xx-xxxxxxx.
Example:
"12-3456789"
Business's email.
Example:
"alice@example.com"
Business's legal name.
Example:
"Apex Corporation"
Date the business was legally registered in RFC 3339 full-date format (YYYY-MM-DD).
Example:
"2000-01-01"
U.S. state where the business is legally registered (2-letter abbreviation).
Example:
"NY"
Legal address
Show child attributes
Show child attributes
Optional field to store additional information about the resource. Intended to be used by the integrator to store non-sensitive data.
Business's phone number with country code in E.164 format. Must have a valid country code. Area code and local phone number are not validated.
Pattern:
^\+[1-9]\d{1,14}$Example:
"+14374570680"
List of spend control IDs to control spending for the customer
Maximum array length:
100Business's legal structure.
Available options:
CORPORATION, LLC, NON_PROFIT, OTHER, PARTNERSHIP, SOLE_PROPRIETORSHIP, S_CORPORATION Example:
"CORPORATION"
The id of the tenant containing the resource. This is relevant for Fintechs that have multiple workspaces.
Example:
"abcdef_ghijkl"
All registered 'doing business as' (DBA) or trade names for this business.
Example:
["Apex", "Apex LLC", "CorporationID#77231"]
Business's website.
Example:
"https://example.com"
Response
The created business.
Represents a business customer.
True for personal and business customers with a direct relationship with the fintech or bank. Set this to true for any customer related to an account.
Example:
true
Status of the business. One of the following:
PROSPECT– a potential customer, used for information-gathering and disclosures.ACTIVE– is an integrator defined status. Integrators should set a business to active if they believe the person to be qualified for conducting business. Synctera will combine this status with other statuses such a verification to determine if the business is eligible for specific actions such as initiating transactions or issuing a card.FROZEN– business's actions are blocked for security, legal, or other reasons.SANCTION– business is on a sanctions list and should be carefully monitored.DISSOLVED– an inactive status indicating a business entity has filed articles of dissolution or a certificate of termination to terminate its existence.CANCELLED– an inactive status indicating that a business entity has filed a cancellation or has failed to file its periodic report after notice of forfeiture of its rights to do business.SUSPENDED– an inactive status indicating that the business entity has lost the right to operate in it's registered jurisdiction.MERGED– an inactive status indicating that the business entity has terminated existence by merging into another entity.INACTIVE– an inactive status indicating that the business entity is no longer active.CONVERTED– An inactive status indicating that the business entity has been converted to another type of business entity in the same jurisdiction.
Available options:
ACTIVE, CANCELLED, CONVERTED, DISSOLVED, FROZEN, INACTIVE, MERGED, PROSPECT, SANCTION, SUSPENDED All of the customer's addresses
Show child attributes
Show child attributes
Specifies the classification of a party for banks. This may contain multiple values for a combined classifications list of customers.
Specifies the classification of a party.
Available options:
AUTHORIZED_USER, BANK_CUSTOMER, INACTIVE_BANK_CUSTOMER, PROSPECT The types of compliance that the business needs to adhere to
LICENSED_CANNABIS– A type of compliance restriction where the business would need a cannabis license in order to operate.
Available options:
LICENSED_CANNABIS The date and time the resource was created.
Example:
"2010-05-06T12:23:34.321Z"
The date and time this business became a bank customer.
Example:
"2010-05-06T12:23:34.321Z"
U.S. Employer Identification Number (EIN) for this business, in the format xx-xxxxxxx.
Example:
"12-3456789"
Business's email.
Example:
"alice@example.com"
Business's legal name.
Example:
"Apex Corporation"
Date the business was legally registered in RFC 3339 full-date format (YYYY-MM-DD).
Example:
"2000-01-01"
U.S. state where the business is legally registered (2-letter abbreviation).
Example:
"NY"
This flag indicates whether the person or business has accounts.
Business's unique identifier.
Example:
"7d943c51-e4ff-4e57-9558-08cab6b963c7"
The date and time the resource was last updated.
Example:
"2010-05-06T12:23:34.321Z"
Legal address
Show child attributes
Show child attributes
Optional field to store additional information about the resource. Intended to be used by the integrator to store non-sensitive data.
Business's phone number with country code in E.164 format. Must have a valid country code. Area code and local phone number are not validated.
Pattern:
^\+[1-9]\d{1,14}$Example:
"+14374570680"
List of spend control IDs to control spending for the customer
Maximum array length:
100Business's legal structure.
Available options:
CORPORATION, LLC, NON_PROFIT, OTHER, PARTNERSHIP, SOLE_PROPRIETORSHIP, S_CORPORATION Example:
"CORPORATION"
The id of the tenant containing the resource. This is relevant for Fintechs that have multiple workspaces.
Example:
"abcdef_ghijkl"
All registered 'doing business as' (DBA) or trade names for this business.
Example:
["Apex", "Apex LLC", "CorporationID#77231"]
Date and time KYB verification was last run on the business.
Example:
"2010-05-06T12:23:34.321Z"
The result of a KYC/KYB verification. One of the following:
UNVERIFIED– verification has not been completed for this customer.PENDING– verification is in progress for this customer.PROVISIONAL– partially verified or verified with restrictions.ACCEPTED– the customer has been verified.REVIEW– verification has run and issues have been identified and require review.REJECTED– the customer was rejected and should not be allowed to take certain actions e.g., open an account.
Available options:
ACCEPTED, PENDING, PROVISIONAL, REJECTED, REVIEW, UNVERIFIED Example:
"ACCEPTED"
Business's website.
Example:
"https://example.com"
Vendor information for external account management systems
Show child attributes
Show child attributes
Was this page helpful?