Customers
Submit customer for verification
Submit a DRAFT customer for verification review.
This endpoint is used when you've progressively built up customer data via PATCH requests and are ready to submit for verification. The customer must be in DRAFT status.
Workflow:
- Create customer → customer is in DRAFT status
- Add data via PATCH /customers/:id as needed
- Call POST /customers/:id/submit to submit for verification
After submission, the customer status transitions to IN_REVIEW. Document AI validation runs asynchronously; validation results are stored on each document's metadata and returned on internal document responses.
For RFI (Request for Information) flows:
- Customer gets NEED_ACTIONS status with missingRequirements
- Add missing data via PATCH /customers/:id
- Call POST /customers/:id/submit to re-submit
post/v1/customers/{id}/submit
Path parameters
idstring required
Example:cus_abc123
Customer ID
Headers
X-API-Keystring
API key
Response
Customer accepted for verification; document AI validation may still be running
Example response
{
"createdAt": "2026-01-15T10:00:00Z",
"updatedAt": "2026-01-15T10:00:00Z",
"customerDetails": {
"firstName": "John",
"lastName": "Smith",
"middleName": "Michael",
"transliteratedFirstName": "Li Ming",
"transliteratedMiddleName": "Wen",
"transliteratedLastName": "Wang",
"dateOfBirth": "1990-01-15",
"nationality": "US",
"phone": "+14155551234",
"occupation": "151252",
"sourceOfIncome": "SALARY"
},
"associatedEntities": [
{
"id": "asp_abc123",
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-01-15T10:30:00Z",
"entityType": "BUSINESS",
"parentEntityId": "asp_parent123",
"details": {
"firstName": "John",
"nickname": "Johnny",
"lastName": "Doe",
"middleName": "Michael",
"dateOfBirth": "1985-03-15",
"taxIdentificationDocumentType": "UTR"
},
"countryCode": "US",
"email": "contact@acmeholdings.com",
"phone": "+14155551234",
"address": {
"addressLine1": "123 Main Street",
"addressLine2": "Apt 4B",
"city": "San Francisco",
"state": "CA",
"postalCode": "94102",
"country": "US",
"transliterated": {
"addressLine1": "123 Main Street",
"addressLine2": "Apt 4B",
"city": "Beijing",
"state": "Hebei"
}
},
"hasOwnership": true,
"hasControl": true,
"ownershipPercentage": 51,
"title": "Managing Director",
"documents": [
"doc_abc123"
],
"attestedOwnershipStructureAt": "2026-01-15T10:30:00Z",
"displayName": "Acme Holdings LLC",
"verificationLink": {
"sessionId": "vsess_abc123",
"verificationUrl": "https://verify.infinite.dev/?sessionId=vsess_abc123",
"expiresAt": "2026-01-09T10:30:00Z",
"status": "ACTIVE"
}
}
],
"addresses": [
{
"addressLine1": "123 Main Street",
"addressLine2": "Apt 4B",
"city": "San Francisco",
"state": "CA",
"postalCode": "94102",
"country": "US",
"transliterated": {
"addressLine1": "123 Main Street",
"addressLine2": "Apt 4B",
"city": "Beijing",
"state": "Hebei"
},
"label": "HOME",
"isDefault": true
}
],
"missingRequirements": [
{
"requirementType": "FIELD",
"key": "businessData.taxIdentificationNumber",
"displayName": "Tax Identification Number"
},
{
"requirementType": "DOCUMENT",
"key": "ownership.ownership_structure",
"displayName": "Ownership Information"
}
],
"accounts": [
[
{
"id": "vba_1234567890abcdef",
"customerId": "cust_abc123",
"type": "VIRTUAL_BANK",
"externalReference": "550e8400-e29b-41d4-a716-446655440000",
"bankDetails": {
"accountNumber": "1234567890",
"routingNumber": "021000021",
"iban": "GB82WEST12345698765432",
"swiftCode": "CHASUS33",
"bankName": "JPMorgan Chase Bank",
"bankCountryCode": "US",
"bankAddress": {
"addressLine1": "270 Park Avenue",
"addressLine2": "Floor 10",
"city": "New York",
"state": "NY",
"postalCode": "10017",
"country": "US"
},
"beneficiaryName": "John Smith",
"beneficiaryPhone": "+14155550123",
"beneficiaryAddress": {
"addressLine1": "123 Main Street",
"addressLine2": "Suite 100",
"city": "New York",
"state": "NY",
"postalCode": "10001",
"country": "US"
},
"supportedNetworks": [
"ACH",
"WIRE"
]
},
"walletDetails": {
"walletAddress": "0x1234567890abcdef1234567890abcdef12345678",
"addressType": "EVM",
"chains": [
"ETHEREUM",
"BASE"
],
"walletType": "TREASURY"
},
"status": "ACTIVE",
"currencyCodes": [
"USD",
"USDC"
],
"virtualBankAccount": {
"id": "vba_1234567890abcdef",
"depositInstructions": {
"bankName": "JPMorgan Chase Bank",
"bankAddress": {
"addressLine1": "270 Park Avenue",
"addressLine2": "Floor 10",
"city": "New York",
"state": "NY",
"postalCode": "10017",
"country": "US"
},
"accountNumber": "1234567890",
"routingNumber": "021000021",
"iban": "GB82WEST12345698765432",
"swiftBic": "CHASUS33",
"bankCountryCode": "US",
"beneficiaryName": "John Doe"
},
"developerFeeFixed": "100000",
"developerFeePercent": 0.01,
"sourceRail": "ACH",
"sourceCurrency": "USD",
"destinationRail": "BASE",
"destinationCurrency": "USDC",
"sweepTargetAccountId": "ewa_1234567890abcdef",
"originCapable": true,
"originAccountId": "vba_1234567890abcdef"
},
"virtualWallet": {
"id": "vw_1234567890abcdef",
"state": "ACTIVE",
"destinationCurrency": "USD",
"destinationRail": "ACH",
"sweepTargetAccountId": "eba_1234567890abcdef",
"originAccountId": "vwa_1234567890abcdef"
},
"proxyDetails": {
"aliasType": "phone",
"aliasValue": "+5511912345678",
"paymentRail": "pix",
"beneficiaryName": "John Smith",
"beneficiaryType": "INDIVIDUAL"
},
"counterpartyId": "cp_abc123",
"referenceId": "550e8400-e29b-41d4-a716-446655440000",
"originCapable": true,
"originAccountId": "vba_1234567890abcdef",
"metadata": {
"nickname": "Main Checking Account",
"purpose": "Business operations",
"tags": [
"primary",
"operations"
]
},
"createdAt": "2026-01-15T10:00:00Z",
"updatedAt": "2026-01-15T10:00:00Z",
"created": true,
"holdsBalance": true,
"paymentRail": "ETHEREUM",
"lastSentAt": "2024-01-15T10:30:00Z",
"lastReceivedAt": "2024-01-15T10:30:00Z",
"counterparty": {
"id": "cp_abc123",
"name": "Jane Doe",
"beneficiaryType": "INDIVIDUAL",
"address": {
"addressLine1": "123 Main Street",
"addressLine2": "Apt 4B",
"city": "San Francisco",
"state": "CA",
"postalCode": "94102",
"country": "US",
"transliterated": {
"addressLine1": "123 Main Street",
"addressLine2": "Apt 4B",
"city": "Beijing",
"state": "Hebei"
}
}
}
}
]
],
"documents": [
{
"id": "doc_abc123",
"organizationId": "org_xyz789",
"customerId": "cus_abc123",
"transferId": "txn_xyz789",
"documentType": "INVOICE",
"documentSubtype": "BANK_STATEMENT",
"fileName": "invoice-2026-001.pdf",
"contentType": "application/pdf",
"sizeBytes": 1024000,
"status": "UPLOADED"
}
],
"treasury": {
"customerId": "cus_abc123",
"treasuries": [
{
"id": "trs_abc123",
"name": "Main Treasury",
"provider": "INFINITE",
"fundingMethods": [
{
"id": "vba_abc123",
"type": "BANK_ACCOUNT",
"provider": "INFINITE",
"currency": "USD",
"currencyCodes": [
"USDC"
],
"rail": "ACH",
"rails": [
"ACH",
"WIRE"
],
"bankName": "Infinite Bank",
"beneficiaryName": "Acme Treasury",
"accountNumber": "1234567890",
"routingNumber": "021000021",
"iban": "GB82WEST12345698765432",
"swiftBic": "CHASUS33",
"address": "0x1234567890abcdef1234567890abcdef12345678",
"addressType": "EVM",
"chains": [
"ETHEREUM",
"BASE"
]
}
],
"wallets": [
{
"address": "0x1234567890abcdef1234567890abcdef12345678",
"addressType": "EVM",
"balances": [
{
"currency": "USDC",
"balance": {
"currency": "USD",
"exponent": 2,
"value": "12345",
"displayValue": "123.45"
},
"chain": "ETHEREUM"
}
]
}
]
}
]
},
"verificationSessions": [
{
"id": "vs_abc123",
"status": "COMPLETED",
"createdAt": "2026-01-15T10:30:00Z",
"completedAt": "2026-01-15T11:00:00Z",
"progressPercentage": 100
}
]
}Changes
No recorded changes to this endpoint across all 1 revision of this API.