curl --request POST \
--url https://api.byzantine.fi/v1/submit/create-individual-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 '
{
"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>"
},
"byzantineTermsSignedAt": "2025-11-19T21:14:58.328Z",
"rootUsers": [
{
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"authenticators": [
{
"authenticatorName": "<string>",
"challenge": "<string>",
"attestation": {
"credentialId": "<string>",
"clientDataJson": "<string>",
"attestationObject": "<string>",
"transports": []
}
}
]
}
],
"additionalUserInfo": {
"employmentStatus": "employed",
"expectedMonthlyPaymentsUsd": "5000_9999",
"sourceOfFunds": "salary",
"mostRecentOccupation": "151252"
},
"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-individual-account"
payload = {
"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>"
},
"byzantineTermsSignedAt": "2025-11-19T21:14:58.328Z",
"rootUsers": [
{
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"authenticators": [
{
"authenticatorName": "<string>",
"challenge": "<string>",
"attestation": {
"credentialId": "<string>",
"clientDataJson": "<string>",
"attestationObject": "<string>",
"transports": []
}
}
]
}
],
"additionalUserInfo": {
"employmentStatus": "employed",
"expectedMonthlyPaymentsUsd": "5000_9999",
"sourceOfFunds": "salary",
"mostRecentOccupation": "151252"
},
"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({
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>'
},
byzantineTermsSignedAt: '2025-11-19T21:14:58.328Z',
rootUsers: [
{
firstName: 'John',
lastName: 'Smith',
email: 'john.smith@example.com',
authenticators: [
{
authenticatorName: '<string>',
challenge: '<string>',
attestation: {
credentialId: '<string>',
clientDataJson: '<string>',
attestationObject: '<string>',
transports: []
}
}
]
}
],
additionalUserInfo: {
employmentStatus: 'employed',
expectedMonthlyPaymentsUsd: '5000_9999',
sourceOfFunds: 'salary',
mostRecentOccupation: '151252'
},
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-individual-account', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"userId": "550e8400-e29b-41d4-a716-446655440000",
"accountId": "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>"
},
"walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18",
"byzantineTermsSignedAt": "2025-11-19T21:14:58.328Z",
"rootUsers": [
{
"userId": "550e8400-e29b-41d4-a716-446655440000",
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"isPasskeyActivated": true,
"isOtpActivated": false
}
],
"additionalUserInfo": {
"employmentStatus": "employed",
"expectedMonthlyPaymentsUsd": "5000_9999",
"sourceOfFunds": "salary",
"mostRecentOccupation": "151252"
},
"verificationDocuments": [
{
"documentType": "passport",
"issuingCountry": "FRA",
"documentId": "830c219c-d197-451d-b879-77936a80c452",
"documentNumber": "FR1234567890",
"description": "Additional supporting document",
"warnings": [
"<string>"
],
"errors": [
"<string>"
]
}
],
"missingDocuments": [
"<string>"
]
}Create individual account
The account beneficiary is the person described in user_info (the KYC subject).
root_users are the signers: the owner themselves (same email), or a
wealth manager / CGP operating on the owner’s behalf.
email must be unique at each call of the endpoint.
You can use the + sign to make them unique, e.g. alice+1@example.com.
It is possible to create an individual account with only the following details and then call the update-individual-account to complete the application:
firstNamelastNameemailbyzantineTermsSignedAt
curl --request POST \
--url https://api.byzantine.fi/v1/submit/create-individual-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 '
{
"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>"
},
"byzantineTermsSignedAt": "2025-11-19T21:14:58.328Z",
"rootUsers": [
{
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"authenticators": [
{
"authenticatorName": "<string>",
"challenge": "<string>",
"attestation": {
"credentialId": "<string>",
"clientDataJson": "<string>",
"attestationObject": "<string>",
"transports": []
}
}
]
}
],
"additionalUserInfo": {
"employmentStatus": "employed",
"expectedMonthlyPaymentsUsd": "5000_9999",
"sourceOfFunds": "salary",
"mostRecentOccupation": "151252"
},
"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-individual-account"
payload = {
"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>"
},
"byzantineTermsSignedAt": "2025-11-19T21:14:58.328Z",
"rootUsers": [
{
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"authenticators": [
{
"authenticatorName": "<string>",
"challenge": "<string>",
"attestation": {
"credentialId": "<string>",
"clientDataJson": "<string>",
"attestationObject": "<string>",
"transports": []
}
}
]
}
],
"additionalUserInfo": {
"employmentStatus": "employed",
"expectedMonthlyPaymentsUsd": "5000_9999",
"sourceOfFunds": "salary",
"mostRecentOccupation": "151252"
},
"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({
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>'
},
byzantineTermsSignedAt: '2025-11-19T21:14:58.328Z',
rootUsers: [
{
firstName: 'John',
lastName: 'Smith',
email: 'john.smith@example.com',
authenticators: [
{
authenticatorName: '<string>',
challenge: '<string>',
attestation: {
credentialId: '<string>',
clientDataJson: '<string>',
attestationObject: '<string>',
transports: []
}
}
]
}
],
additionalUserInfo: {
employmentStatus: 'employed',
expectedMonthlyPaymentsUsd: '5000_9999',
sourceOfFunds: 'salary',
mostRecentOccupation: '151252'
},
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-individual-account', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"userId": "550e8400-e29b-41d4-a716-446655440000",
"accountId": "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>"
},
"walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18",
"byzantineTermsSignedAt": "2025-11-19T21:14:58.328Z",
"rootUsers": [
{
"userId": "550e8400-e29b-41d4-a716-446655440000",
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"isPasskeyActivated": true,
"isOtpActivated": false
}
],
"additionalUserInfo": {
"employmentStatus": "employed",
"expectedMonthlyPaymentsUsd": "5000_9999",
"sourceOfFunds": "salary",
"mostRecentOccupation": "151252"
},
"verificationDocuments": [
{
"documentType": "passport",
"issuingCountry": "FRA",
"documentId": "830c219c-d197-451d-b879-77936a80c452",
"documentNumber": "FR1234567890",
"description": "Additional supporting document",
"warnings": [
"<string>"
],
"errors": [
"<string>"
]
}
],
"missingDocuments": [
"<string>"
]
}Headers
Body
Byzantine individual account creation body
User to be created. The vast majority of fields are required in order to complete the identity verification process.
The timestamp when the Byzantine Finance Terms & Conditions were signed. For more information, see individual account creation - KYC.
"2025-11-19T21:14:58.328Z"
Response
Individual account created successfully
Response body for creating a Byzantine user
The timestamp when the Byzantine Finance Terms & Conditions were signed. For more information, see individual account creation - KYC.
"2025-11-19T21:14:58.328Z"

