Create entity
curl --request POST \
--url https://api.byzantine.fi/v1/submit/create-entity-account \
--header 'Content-Type: application/json' \
--header 'X-Pubkey: <x-pubkey>' \
--header 'X-Pubkey, X-Timestamp, X-Signature: <api-key>' \
--header 'X-Signature: <x-signature>' \
--header 'X-Timestamp: <x-timestamp>' \
--data '
{
"entityInfo": {
"businessLegalName": "ByzCorp Incorporated",
"businessTradeName": "ByzCorp",
"businessType": "llc",
"companyNumber": "123456789",
"email": "byzcorp@example.com",
"website": "byzcorp.com",
"logoUrl": "https://byzcorp.com/logo.png",
"registeredAddress": {
"streetLine1": "33 Rue La Fayette",
"city": "Paris",
"postalCode": "75009",
"country": "FRA",
"streetLine2": "WeWork",
"state": "IDF"
},
"physicalAddress": {
"streetLine1": "33 Rue La Fayette",
"city": "Paris",
"postalCode": "75009",
"country": "FRA",
"streetLine2": "WeWork",
"state": "IDF"
},
"activityInfo": {
"businessDescription": "ByzCorp does business.",
"businessIndustry": 523110
},
"financialInfo": {
"sourceOfFunds": "treasury_reserves",
"estimatedAnnualRevenueUsd": "1000000_9999999",
"expectedMonthlyPaymentsUsd": 5000000,
"hasMaterialIntermediaryEntityOwner": false
},
"highRiskInfo": {
"operatesInProhibitedCountries": false,
"highRiskActivities": "none_of_the_above",
"highRiskActivitiesExplanation": "<string>",
"conductsMoneyServices": false,
"conductsMoneyServicesDescription": "<string>"
}
},
"rootUsers": [
{
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"authenticators": [
{
"authenticatorName": "<string>",
"challenge": "<string>",
"attestation": {
"credentialId": "<string>",
"clientDataJson": "<string>",
"attestationObject": "<string>",
"transports": []
}
}
]
}
],
"byzantineTermsSignedAt": "2025-11-19T21:14:58.328Z",
"entityDocuments": [
{
"documentType": "incorporation_cert",
"issuingCountry": "FRA",
"document": "data:image/png;base64,iVBORw0lFTkSuQmCC...",
"description": "An overview of our business activities."
}
],
"associatedPersons": [
{
"userInfo": {
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"middleName": "William",
"phone": "+33 123 456 789",
"birthDate": "1990-01-01",
"nationality": "FRA",
"countryOfBirth": "FRA",
"residentialAddress": {
"streetLine1": "33 Rue La Fayette",
"city": "Paris",
"postalCode": "75009",
"country": "FRA",
"streetLine2": "WeWork",
"state": "IDF"
},
"socialSecurityNumber": "123-45-6789",
"profilePictureUrl": "<string>"
},
"beneficiaryDetails": {
"beneficiaryType": [
"ubo"
],
"title": "CEO",
"ownershipPercentage": 32.5
},
"verificationDocuments": [
{
"issuingCountry": "FRA",
"document": "data:image/png;base64,iVBORw0lFTkSuQmCC...",
"documentNumber": "FR1234567890",
"description": "Additional supporting document"
}
]
}
],
"walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18"
}
'import requests
url = "https://api.byzantine.fi/v1/submit/create-entity-account"
payload = {
"entityInfo": {
"businessLegalName": "ByzCorp Incorporated",
"businessTradeName": "ByzCorp",
"businessType": "llc",
"companyNumber": "123456789",
"email": "byzcorp@example.com",
"website": "byzcorp.com",
"logoUrl": "https://byzcorp.com/logo.png",
"registeredAddress": {
"streetLine1": "33 Rue La Fayette",
"city": "Paris",
"postalCode": "75009",
"country": "FRA",
"streetLine2": "WeWork",
"state": "IDF"
},
"physicalAddress": {
"streetLine1": "33 Rue La Fayette",
"city": "Paris",
"postalCode": "75009",
"country": "FRA",
"streetLine2": "WeWork",
"state": "IDF"
},
"activityInfo": {
"businessDescription": "ByzCorp does business.",
"businessIndustry": 523110
},
"financialInfo": {
"sourceOfFunds": "treasury_reserves",
"estimatedAnnualRevenueUsd": "1000000_9999999",
"expectedMonthlyPaymentsUsd": 5000000,
"hasMaterialIntermediaryEntityOwner": False
},
"highRiskInfo": {
"operatesInProhibitedCountries": False,
"highRiskActivities": "none_of_the_above",
"highRiskActivitiesExplanation": "<string>",
"conductsMoneyServices": False,
"conductsMoneyServicesDescription": "<string>"
}
},
"rootUsers": [
{
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"authenticators": [
{
"authenticatorName": "<string>",
"challenge": "<string>",
"attestation": {
"credentialId": "<string>",
"clientDataJson": "<string>",
"attestationObject": "<string>",
"transports": []
}
}
]
}
],
"byzantineTermsSignedAt": "2025-11-19T21:14:58.328Z",
"entityDocuments": [
{
"documentType": "incorporation_cert",
"issuingCountry": "FRA",
"document": "data:image/png;base64,iVBORw0lFTkSuQmCC...",
"description": "An overview of our business activities."
}
],
"associatedPersons": [
{
"userInfo": {
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"middleName": "William",
"phone": "+33 123 456 789",
"birthDate": "1990-01-01",
"nationality": "FRA",
"countryOfBirth": "FRA",
"residentialAddress": {
"streetLine1": "33 Rue La Fayette",
"city": "Paris",
"postalCode": "75009",
"country": "FRA",
"streetLine2": "WeWork",
"state": "IDF"
},
"socialSecurityNumber": "123-45-6789",
"profilePictureUrl": "<string>"
},
"beneficiaryDetails": {
"beneficiaryType": ["ubo"],
"title": "CEO",
"ownershipPercentage": 32.5
},
"verificationDocuments": [
{
"issuingCountry": "FRA",
"document": "data:image/png;base64,iVBORw0lFTkSuQmCC...",
"documentNumber": "FR1234567890",
"description": "Additional supporting document"
}
]
}
],
"walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18"
}
headers = {
"X-Pubkey": "<x-pubkey>",
"X-Timestamp": "<x-timestamp>",
"X-Signature": "<x-signature>",
"X-Pubkey, X-Timestamp, X-Signature": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Pubkey': '<x-pubkey>',
'X-Timestamp': '<x-timestamp>',
'X-Signature': '<x-signature>',
'X-Pubkey, X-Timestamp, X-Signature': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
entityInfo: {
businessLegalName: 'ByzCorp Incorporated',
businessTradeName: 'ByzCorp',
businessType: 'llc',
companyNumber: '123456789',
email: 'byzcorp@example.com',
website: 'byzcorp.com',
logoUrl: 'https://byzcorp.com/logo.png',
registeredAddress: {
streetLine1: '33 Rue La Fayette',
city: 'Paris',
postalCode: '75009',
country: 'FRA',
streetLine2: 'WeWork',
state: 'IDF'
},
physicalAddress: {
streetLine1: '33 Rue La Fayette',
city: 'Paris',
postalCode: '75009',
country: 'FRA',
streetLine2: 'WeWork',
state: 'IDF'
},
activityInfo: {businessDescription: 'ByzCorp does business.', businessIndustry: 523110},
financialInfo: {
sourceOfFunds: 'treasury_reserves',
estimatedAnnualRevenueUsd: '1000000_9999999',
expectedMonthlyPaymentsUsd: 5000000,
hasMaterialIntermediaryEntityOwner: false
},
highRiskInfo: {
operatesInProhibitedCountries: false,
highRiskActivities: 'none_of_the_above',
highRiskActivitiesExplanation: '<string>',
conductsMoneyServices: false,
conductsMoneyServicesDescription: '<string>'
}
},
rootUsers: [
{
firstName: 'John',
lastName: 'Smith',
email: 'john.smith@example.com',
authenticators: [
{
authenticatorName: '<string>',
challenge: '<string>',
attestation: {
credentialId: '<string>',
clientDataJson: '<string>',
attestationObject: '<string>',
transports: []
}
}
]
}
],
byzantineTermsSignedAt: '2025-11-19T21:14:58.328Z',
entityDocuments: [
{
documentType: 'incorporation_cert',
issuingCountry: 'FRA',
document: 'data:image/png;base64,iVBORw0lFTkSuQmCC...',
description: 'An overview of our business activities.'
}
],
associatedPersons: [
{
userInfo: {
firstName: 'John',
lastName: 'Smith',
email: 'john.smith@example.com',
middleName: 'William',
phone: '+33 123 456 789',
birthDate: '1990-01-01',
nationality: 'FRA',
countryOfBirth: 'FRA',
residentialAddress: {
streetLine1: '33 Rue La Fayette',
city: 'Paris',
postalCode: '75009',
country: 'FRA',
streetLine2: 'WeWork',
state: 'IDF'
},
socialSecurityNumber: '123-45-6789',
profilePictureUrl: '<string>'
},
beneficiaryDetails: {beneficiaryType: ['ubo'], title: 'CEO', ownershipPercentage: 32.5},
verificationDocuments: [
{
issuingCountry: 'FRA',
document: 'data:image/png;base64,iVBORw0lFTkSuQmCC...',
documentNumber: 'FR1234567890',
description: 'Additional supporting document'
}
]
}
],
walletAddress: '0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18'
})
};
fetch('https://api.byzantine.fi/v1/submit/create-entity-account', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"entityId": "550e8400-e29b-41d4-a716-446655440000",
"accountId": "550e8400-e29b-41d4-a716-446655440000",
"verificationStatus": "active",
"entityInfo": {
"businessLegalName": "ByzCorp Incorporated",
"businessTradeName": "ByzCorp",
"businessType": "llc",
"companyNumber": "123456789",
"email": "byzcorp@example.com",
"website": "byzcorp.com",
"logoUrl": "https://byzcorp.com/logo.png",
"registeredAddress": {
"streetLine1": "33 Rue La Fayette",
"city": "Paris",
"postalCode": "75009",
"country": "FRA",
"streetLine2": "WeWork",
"state": "IDF"
},
"physicalAddress": {
"streetLine1": "33 Rue La Fayette",
"city": "Paris",
"postalCode": "75009",
"country": "FRA",
"streetLine2": "WeWork",
"state": "IDF"
},
"activityInfo": {
"businessDescription": "ByzCorp does business.",
"businessIndustry": 523110
},
"financialInfo": {
"preferredPrimaryCurrency": "usd",
"sourceOfFunds": "treasury_reserves",
"estimatedAnnualRevenueUsd": "1000000_9999999",
"expectedMonthlyPaymentsUsd": 5000000,
"hasMaterialIntermediaryEntityOwner": false
},
"highRiskInfo": {
"operatesInProhibitedCountries": false,
"highRiskActivities": "none_of_the_above",
"highRiskActivitiesExplanation": "<string>",
"conductsMoneyServices": false,
"conductsMoneyServicesDescription": "<string>"
}
},
"rootUsers": [
{
"userId": "550e8400-e29b-41d4-a716-446655440000",
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"isPasskeyActivated": true,
"isOtpActivated": false
}
],
"walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18",
"byzantineTermsSignedAt": "2025-11-19T21:14:58.328Z",
"entityDocuments": [
{
"documentType": "passport",
"issuingCountry": "FRA",
"documentId": "830c219c-d197-451d-b879-77936a80c452",
"documentNumber": "FR1234567890",
"description": "Additional supporting document",
"warnings": [
"<string>"
],
"errors": [
"<string>"
]
}
],
"associatedPersons": [
{
"beneficiaryId": "550e8400-e29b-41d4-a716-446655440000",
"verificationStatus": "active",
"userInfo": {
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"middleName": "William",
"phone": "+33 123 456 789",
"birthDate": "1990-01-01",
"nationality": "FRA",
"countryOfBirth": "FRA",
"residentialAddress": {
"streetLine1": "33 Rue La Fayette",
"city": "Paris",
"postalCode": "75009",
"country": "FRA",
"streetLine2": "WeWork",
"state": "IDF"
},
"socialSecurityNumber": "123-45-6789",
"profilePictureUrl": "<string>"
},
"beneficiaryDetails": {
"beneficiaryType": [
"ubo"
],
"title": "CEO",
"ownershipPercentage": 32.5
},
"verificationDocuments": [
{
"documentType": "passport",
"issuingCountry": "FRA",
"documentId": "830c219c-d197-451d-b879-77936a80c452",
"documentNumber": "FR1234567890",
"description": "Additional supporting document",
"warnings": [
"<string>"
],
"errors": [
"<string>"
]
}
],
"missingDocuments": [
"<string>"
]
}
],
"missingCompanyData": [
"<string>"
],
"missingDocuments": [
"<string>"
]
}Customer creation
Create entity
email and associatedPersons.email must be unique at each call of the endpoint.
For emails, you can use the + sign to make them unique, e.g. byzcorp+1@example.com.
POST
/
v1
/
submit
/
create-entity-account
Create entity
curl --request POST \
--url https://api.byzantine.fi/v1/submit/create-entity-account \
--header 'Content-Type: application/json' \
--header 'X-Pubkey: <x-pubkey>' \
--header 'X-Pubkey, X-Timestamp, X-Signature: <api-key>' \
--header 'X-Signature: <x-signature>' \
--header 'X-Timestamp: <x-timestamp>' \
--data '
{
"entityInfo": {
"businessLegalName": "ByzCorp Incorporated",
"businessTradeName": "ByzCorp",
"businessType": "llc",
"companyNumber": "123456789",
"email": "byzcorp@example.com",
"website": "byzcorp.com",
"logoUrl": "https://byzcorp.com/logo.png",
"registeredAddress": {
"streetLine1": "33 Rue La Fayette",
"city": "Paris",
"postalCode": "75009",
"country": "FRA",
"streetLine2": "WeWork",
"state": "IDF"
},
"physicalAddress": {
"streetLine1": "33 Rue La Fayette",
"city": "Paris",
"postalCode": "75009",
"country": "FRA",
"streetLine2": "WeWork",
"state": "IDF"
},
"activityInfo": {
"businessDescription": "ByzCorp does business.",
"businessIndustry": 523110
},
"financialInfo": {
"sourceOfFunds": "treasury_reserves",
"estimatedAnnualRevenueUsd": "1000000_9999999",
"expectedMonthlyPaymentsUsd": 5000000,
"hasMaterialIntermediaryEntityOwner": false
},
"highRiskInfo": {
"operatesInProhibitedCountries": false,
"highRiskActivities": "none_of_the_above",
"highRiskActivitiesExplanation": "<string>",
"conductsMoneyServices": false,
"conductsMoneyServicesDescription": "<string>"
}
},
"rootUsers": [
{
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"authenticators": [
{
"authenticatorName": "<string>",
"challenge": "<string>",
"attestation": {
"credentialId": "<string>",
"clientDataJson": "<string>",
"attestationObject": "<string>",
"transports": []
}
}
]
}
],
"byzantineTermsSignedAt": "2025-11-19T21:14:58.328Z",
"entityDocuments": [
{
"documentType": "incorporation_cert",
"issuingCountry": "FRA",
"document": "data:image/png;base64,iVBORw0lFTkSuQmCC...",
"description": "An overview of our business activities."
}
],
"associatedPersons": [
{
"userInfo": {
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"middleName": "William",
"phone": "+33 123 456 789",
"birthDate": "1990-01-01",
"nationality": "FRA",
"countryOfBirth": "FRA",
"residentialAddress": {
"streetLine1": "33 Rue La Fayette",
"city": "Paris",
"postalCode": "75009",
"country": "FRA",
"streetLine2": "WeWork",
"state": "IDF"
},
"socialSecurityNumber": "123-45-6789",
"profilePictureUrl": "<string>"
},
"beneficiaryDetails": {
"beneficiaryType": [
"ubo"
],
"title": "CEO",
"ownershipPercentage": 32.5
},
"verificationDocuments": [
{
"issuingCountry": "FRA",
"document": "data:image/png;base64,iVBORw0lFTkSuQmCC...",
"documentNumber": "FR1234567890",
"description": "Additional supporting document"
}
]
}
],
"walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18"
}
'import requests
url = "https://api.byzantine.fi/v1/submit/create-entity-account"
payload = {
"entityInfo": {
"businessLegalName": "ByzCorp Incorporated",
"businessTradeName": "ByzCorp",
"businessType": "llc",
"companyNumber": "123456789",
"email": "byzcorp@example.com",
"website": "byzcorp.com",
"logoUrl": "https://byzcorp.com/logo.png",
"registeredAddress": {
"streetLine1": "33 Rue La Fayette",
"city": "Paris",
"postalCode": "75009",
"country": "FRA",
"streetLine2": "WeWork",
"state": "IDF"
},
"physicalAddress": {
"streetLine1": "33 Rue La Fayette",
"city": "Paris",
"postalCode": "75009",
"country": "FRA",
"streetLine2": "WeWork",
"state": "IDF"
},
"activityInfo": {
"businessDescription": "ByzCorp does business.",
"businessIndustry": 523110
},
"financialInfo": {
"sourceOfFunds": "treasury_reserves",
"estimatedAnnualRevenueUsd": "1000000_9999999",
"expectedMonthlyPaymentsUsd": 5000000,
"hasMaterialIntermediaryEntityOwner": False
},
"highRiskInfo": {
"operatesInProhibitedCountries": False,
"highRiskActivities": "none_of_the_above",
"highRiskActivitiesExplanation": "<string>",
"conductsMoneyServices": False,
"conductsMoneyServicesDescription": "<string>"
}
},
"rootUsers": [
{
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"authenticators": [
{
"authenticatorName": "<string>",
"challenge": "<string>",
"attestation": {
"credentialId": "<string>",
"clientDataJson": "<string>",
"attestationObject": "<string>",
"transports": []
}
}
]
}
],
"byzantineTermsSignedAt": "2025-11-19T21:14:58.328Z",
"entityDocuments": [
{
"documentType": "incorporation_cert",
"issuingCountry": "FRA",
"document": "data:image/png;base64,iVBORw0lFTkSuQmCC...",
"description": "An overview of our business activities."
}
],
"associatedPersons": [
{
"userInfo": {
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"middleName": "William",
"phone": "+33 123 456 789",
"birthDate": "1990-01-01",
"nationality": "FRA",
"countryOfBirth": "FRA",
"residentialAddress": {
"streetLine1": "33 Rue La Fayette",
"city": "Paris",
"postalCode": "75009",
"country": "FRA",
"streetLine2": "WeWork",
"state": "IDF"
},
"socialSecurityNumber": "123-45-6789",
"profilePictureUrl": "<string>"
},
"beneficiaryDetails": {
"beneficiaryType": ["ubo"],
"title": "CEO",
"ownershipPercentage": 32.5
},
"verificationDocuments": [
{
"issuingCountry": "FRA",
"document": "data:image/png;base64,iVBORw0lFTkSuQmCC...",
"documentNumber": "FR1234567890",
"description": "Additional supporting document"
}
]
}
],
"walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18"
}
headers = {
"X-Pubkey": "<x-pubkey>",
"X-Timestamp": "<x-timestamp>",
"X-Signature": "<x-signature>",
"X-Pubkey, X-Timestamp, X-Signature": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Pubkey': '<x-pubkey>',
'X-Timestamp': '<x-timestamp>',
'X-Signature': '<x-signature>',
'X-Pubkey, X-Timestamp, X-Signature': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
entityInfo: {
businessLegalName: 'ByzCorp Incorporated',
businessTradeName: 'ByzCorp',
businessType: 'llc',
companyNumber: '123456789',
email: 'byzcorp@example.com',
website: 'byzcorp.com',
logoUrl: 'https://byzcorp.com/logo.png',
registeredAddress: {
streetLine1: '33 Rue La Fayette',
city: 'Paris',
postalCode: '75009',
country: 'FRA',
streetLine2: 'WeWork',
state: 'IDF'
},
physicalAddress: {
streetLine1: '33 Rue La Fayette',
city: 'Paris',
postalCode: '75009',
country: 'FRA',
streetLine2: 'WeWork',
state: 'IDF'
},
activityInfo: {businessDescription: 'ByzCorp does business.', businessIndustry: 523110},
financialInfo: {
sourceOfFunds: 'treasury_reserves',
estimatedAnnualRevenueUsd: '1000000_9999999',
expectedMonthlyPaymentsUsd: 5000000,
hasMaterialIntermediaryEntityOwner: false
},
highRiskInfo: {
operatesInProhibitedCountries: false,
highRiskActivities: 'none_of_the_above',
highRiskActivitiesExplanation: '<string>',
conductsMoneyServices: false,
conductsMoneyServicesDescription: '<string>'
}
},
rootUsers: [
{
firstName: 'John',
lastName: 'Smith',
email: 'john.smith@example.com',
authenticators: [
{
authenticatorName: '<string>',
challenge: '<string>',
attestation: {
credentialId: '<string>',
clientDataJson: '<string>',
attestationObject: '<string>',
transports: []
}
}
]
}
],
byzantineTermsSignedAt: '2025-11-19T21:14:58.328Z',
entityDocuments: [
{
documentType: 'incorporation_cert',
issuingCountry: 'FRA',
document: 'data:image/png;base64,iVBORw0lFTkSuQmCC...',
description: 'An overview of our business activities.'
}
],
associatedPersons: [
{
userInfo: {
firstName: 'John',
lastName: 'Smith',
email: 'john.smith@example.com',
middleName: 'William',
phone: '+33 123 456 789',
birthDate: '1990-01-01',
nationality: 'FRA',
countryOfBirth: 'FRA',
residentialAddress: {
streetLine1: '33 Rue La Fayette',
city: 'Paris',
postalCode: '75009',
country: 'FRA',
streetLine2: 'WeWork',
state: 'IDF'
},
socialSecurityNumber: '123-45-6789',
profilePictureUrl: '<string>'
},
beneficiaryDetails: {beneficiaryType: ['ubo'], title: 'CEO', ownershipPercentage: 32.5},
verificationDocuments: [
{
issuingCountry: 'FRA',
document: 'data:image/png;base64,iVBORw0lFTkSuQmCC...',
documentNumber: 'FR1234567890',
description: 'Additional supporting document'
}
]
}
],
walletAddress: '0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18'
})
};
fetch('https://api.byzantine.fi/v1/submit/create-entity-account', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"entityId": "550e8400-e29b-41d4-a716-446655440000",
"accountId": "550e8400-e29b-41d4-a716-446655440000",
"verificationStatus": "active",
"entityInfo": {
"businessLegalName": "ByzCorp Incorporated",
"businessTradeName": "ByzCorp",
"businessType": "llc",
"companyNumber": "123456789",
"email": "byzcorp@example.com",
"website": "byzcorp.com",
"logoUrl": "https://byzcorp.com/logo.png",
"registeredAddress": {
"streetLine1": "33 Rue La Fayette",
"city": "Paris",
"postalCode": "75009",
"country": "FRA",
"streetLine2": "WeWork",
"state": "IDF"
},
"physicalAddress": {
"streetLine1": "33 Rue La Fayette",
"city": "Paris",
"postalCode": "75009",
"country": "FRA",
"streetLine2": "WeWork",
"state": "IDF"
},
"activityInfo": {
"businessDescription": "ByzCorp does business.",
"businessIndustry": 523110
},
"financialInfo": {
"preferredPrimaryCurrency": "usd",
"sourceOfFunds": "treasury_reserves",
"estimatedAnnualRevenueUsd": "1000000_9999999",
"expectedMonthlyPaymentsUsd": 5000000,
"hasMaterialIntermediaryEntityOwner": false
},
"highRiskInfo": {
"operatesInProhibitedCountries": false,
"highRiskActivities": "none_of_the_above",
"highRiskActivitiesExplanation": "<string>",
"conductsMoneyServices": false,
"conductsMoneyServicesDescription": "<string>"
}
},
"rootUsers": [
{
"userId": "550e8400-e29b-41d4-a716-446655440000",
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"isPasskeyActivated": true,
"isOtpActivated": false
}
],
"walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18",
"byzantineTermsSignedAt": "2025-11-19T21:14:58.328Z",
"entityDocuments": [
{
"documentType": "passport",
"issuingCountry": "FRA",
"documentId": "830c219c-d197-451d-b879-77936a80c452",
"documentNumber": "FR1234567890",
"description": "Additional supporting document",
"warnings": [
"<string>"
],
"errors": [
"<string>"
]
}
],
"associatedPersons": [
{
"beneficiaryId": "550e8400-e29b-41d4-a716-446655440000",
"verificationStatus": "active",
"userInfo": {
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"middleName": "William",
"phone": "+33 123 456 789",
"birthDate": "1990-01-01",
"nationality": "FRA",
"countryOfBirth": "FRA",
"residentialAddress": {
"streetLine1": "33 Rue La Fayette",
"city": "Paris",
"postalCode": "75009",
"country": "FRA",
"streetLine2": "WeWork",
"state": "IDF"
},
"socialSecurityNumber": "123-45-6789",
"profilePictureUrl": "<string>"
},
"beneficiaryDetails": {
"beneficiaryType": [
"ubo"
],
"title": "CEO",
"ownershipPercentage": 32.5
},
"verificationDocuments": [
{
"documentType": "passport",
"issuingCountry": "FRA",
"documentId": "830c219c-d197-451d-b879-77936a80c452",
"documentNumber": "FR1234567890",
"description": "Additional supporting document",
"warnings": [
"<string>"
],
"errors": [
"<string>"
]
}
],
"missingDocuments": [
"<string>"
]
}
],
"missingCompanyData": [
"<string>"
],
"missingDocuments": [
"<string>"
]
}Authorizations
Headers
Integrator's ECDSA public key (P-256 curve, compressed SEC1 format). Example: 0x038fedef7c12f93bbf342ad8943b7a825a3b41f61c9dc118b2c718efebabbf62fd
Unix timestamp in seconds (UTC). Must be within tolerance window (1 minute) to prevent replay attacks. Example: 1760375826
ECDSA signature (DER-encoded, hex with 0x prefix). Signs the message: {timestamp}{METHOD}{path_and_query}{json_body}. Example: 0x3045022100...
Body
application/json
Byzantine entity account creation body
Request body for creating a Byzantine entity
Entity information for KYB
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The timestamp when the Byzantine Finance Terms & Conditions were signed. For more information, see individual account creation - KYC.
Example:
"2025-11-19T21:14:58.328Z"
Entity verification documents. The verification check is only requested once the four required groups are covered: company details, ownership structure, source of funds and proof of address. See accepted documents.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Optional wallet address for self-custodial accounts. If provided, no Turnkey sub-organization will be created and required_approvals will be set to 0.
Example:
"0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18"
Response
Entity account created successfully
Response body for creating a Byzantine entity
A UUID string
Example:
"550e8400-e29b-41d4-a716-446655440000"
A UUID string
Example:
"550e8400-e29b-41d4-a716-446655440000"
The identity verification status of the user.
Available options:
not_started, init, under_review, awaiting_associated_person_information, awaiting_information, resubmission_requested, active, rejected, inactive Example:
"active"
Entity information for KYB
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The wallet address associated with this account.
Example:
"0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18"
The timestamp when the Byzantine Finance Terms & Conditions were signed. For more information, see individual account creation - KYC.
Example:
"2025-11-19T21:14:58.328Z"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
List of missing required company data. Present only if not all required company information has been provided.
List of missing required entity verification documents. Present only if not all required documents have been submitted.
Values: COMPANY_DETAILS_DOCUMENT, OWNERSHIP_STRUCTURE_DOCUMENT, SOURCE_OF_FUNDS_DOCUMENT,
PROOF_OF_ADDRESS_DOCUMENT, PHYSICAL_ADDRESS_QUESTIONNAIRE, ACTIVITY_INFO_QUESTIONNAIRE,
FINANCIAL_INFO_QUESTIONNAIRE.