Create a customer

curl --request POST \
  --url https://api.conduit.financial/customers \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'X-API-Secret: <api-key>' \
  --data '
{
  "businessLegalName": "Acme Corp",
  "country": "USA",
  "onboardingFlow": "direct",
  "businessInformation": {
    "hasDBA": false,
    "businessDescription": "Provider of industrial widgets and services",
    "isSubsidiary": false,
    "entityType": "Bank",
    "isOperating": true,
    "regulatorName": "FinCEN (Financial Crimes Enforcement Network)",
    "businessEntityType": "Corporation",
    "registeredDate": "2024-01-01",
    "website": "https://acme.com",
    "email": "contact@acme.com",
    "phone": "+1234567890",
    "industry": "MSB/Payments Company",
    "taxIdentificationNumber": "123456789",
    "businessEntityId": "BE001",
    "naicsCode": "NAIS001",
    "isFinancialInstitution": false,
    "registeredAddress": {
      "streetLine1": "123 Business St",
      "city": "New York",
      "state": "NY",
      "postalCode": "10001",
      "country": "USA"
    },
    "operatingAddress": {
      "streetLine1": "456 Office Ave",
      "city": "New York",
      "state": "NY",
      "postalCode": "10002",
      "country": "USA"
    },
    "isStockExchangeListed": false,
    "accountPurpose": "Payroll/ Employee Payouts",
    "highRiskIndustry": "Third-party / OBO payments",
    "highRiskIndustryDetails": "We facilitate payments for gig economy platforms, primarily for food delivery and ride-sharing services.",
    "hasNestedFlows": true,
    "nestedFlowDescription": "We manage escrow accounts for multiple vendors and process vendor payouts on behalf of our platform customers.",
    "certifiesOwnTreasuryUse": true,
    "keyGeographicBusinessCountries": [
      "USA",
      "CAN"
    ],
    "anticipatedTransactionsVolume": 1500,
    "usesBlockChainWallets": false,
    "anticipatedMonthlyVolume": 50000,
    "expectedAverageDailyBalance": 250000,
    "sourceOfFunds": "Revenue From Products/Services",
    "productsOrServices": [
      "Cross-Border Payments"
    ],
    "isGeneratingRevenues": true,
    "revenueCoverage": "More than 50% of expenses and growing",
    "hasInstitutionalInvestors": true,
    "runwayDurationMonths": "More than 12 months",
    "cashOnHandUsd": 500000,
    "hasUsBankAccount": true,
    "deniedUsBankAccount": {
      "answer": true,
      "explanation": "Application was denied by XYZ Bank in 2022 due to insufficient documentation at the time."
    },
    "businessAuditHistory": {
      "answer": true,
      "explanation": "Underwent tax audit by HMRC in 2021, resolved with no outstanding issues."
    },
    "ownersAuditHistory": {
      "answer": false,
      "explanation": "No owners audit history"
    },
    "pepInvolved": {
      "answer": false,
      "explanation": "No PEP involvement"
    },
    "hasAdvisor": true,
    "flowOfFundsDescription": "Funds are collected from customers via payment processing and disbursed to vendors and suppliers.",
    "termsOfServiceAcceptance": {
      "date": "2025-07-28",
      "ipAddress": "201.221.240.218",
      "isAuthenticated": true
    }
  }
}
'

{
  "onboardingFlow": "direct",
  "id": "cus_2ofTA13AD0xBtbEvBl20aEb1hEu",
  "status": "created",
  "businessLegalName": "Example Business"
}

POST

customers

curl --request POST \
  --url https://api.conduit.financial/customers \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'X-API-Secret: <api-key>' \
  --data '
{
  "businessLegalName": "Acme Corp",
  "country": "USA",
  "onboardingFlow": "direct",
  "businessInformation": {
    "hasDBA": false,
    "businessDescription": "Provider of industrial widgets and services",
    "isSubsidiary": false,
    "entityType": "Bank",
    "isOperating": true,
    "regulatorName": "FinCEN (Financial Crimes Enforcement Network)",
    "businessEntityType": "Corporation",
    "registeredDate": "2024-01-01",
    "website": "https://acme.com",
    "email": "contact@acme.com",
    "phone": "+1234567890",
    "industry": "MSB/Payments Company",
    "taxIdentificationNumber": "123456789",
    "businessEntityId": "BE001",
    "naicsCode": "NAIS001",
    "isFinancialInstitution": false,
    "registeredAddress": {
      "streetLine1": "123 Business St",
      "city": "New York",
      "state": "NY",
      "postalCode": "10001",
      "country": "USA"
    },
    "operatingAddress": {
      "streetLine1": "456 Office Ave",
      "city": "New York",
      "state": "NY",
      "postalCode": "10002",
      "country": "USA"
    },
    "isStockExchangeListed": false,
    "accountPurpose": "Payroll/ Employee Payouts",
    "highRiskIndustry": "Third-party / OBO payments",
    "highRiskIndustryDetails": "We facilitate payments for gig economy platforms, primarily for food delivery and ride-sharing services.",
    "hasNestedFlows": true,
    "nestedFlowDescription": "We manage escrow accounts for multiple vendors and process vendor payouts on behalf of our platform customers.",
    "certifiesOwnTreasuryUse": true,
    "keyGeographicBusinessCountries": [
      "USA",
      "CAN"
    ],
    "anticipatedTransactionsVolume": 1500,
    "usesBlockChainWallets": false,
    "anticipatedMonthlyVolume": 50000,
    "expectedAverageDailyBalance": 250000,
    "sourceOfFunds": "Revenue From Products/Services",
    "productsOrServices": [
      "Cross-Border Payments"
    ],
    "isGeneratingRevenues": true,
    "revenueCoverage": "More than 50% of expenses and growing",
    "hasInstitutionalInvestors": true,
    "runwayDurationMonths": "More than 12 months",
    "cashOnHandUsd": 500000,
    "hasUsBankAccount": true,
    "deniedUsBankAccount": {
      "answer": true,
      "explanation": "Application was denied by XYZ Bank in 2022 due to insufficient documentation at the time."
    },
    "businessAuditHistory": {
      "answer": true,
      "explanation": "Underwent tax audit by HMRC in 2021, resolved with no outstanding issues."
    },
    "ownersAuditHistory": {
      "answer": false,
      "explanation": "No owners audit history"
    },
    "pepInvolved": {
      "answer": false,
      "explanation": "No PEP involvement"
    },
    "hasAdvisor": true,
    "flowOfFundsDescription": "Funds are collected from customers via payment processing and disbursed to vendors and suppliers.",
    "termsOfServiceAcceptance": {
      "date": "2025-07-28",
      "ipAddress": "201.221.240.218",
      "isAuthenticated": true
    }
  }
}
'

{
  "onboardingFlow": "direct",
  "id": "cus_2ofTA13AD0xBtbEvBl20aEb1hEu",
  "status": "created",
  "businessLegalName": "Example Business"
}

Authorizations

X-API-Key

string

header

required

Includes an API key in the HTTP headers to authenticate the client.

X-API-Secret

string

header

required

Includes an API secret in the HTTP headers to authenticate the client.

Body

application/json

Option 1
Option 2

Create Customer Request

businessLegalName

string

required

The legal name of the business

Minimum string length: 1

country

string

required

The country where the business is located

Required string length: 3

onboardingFlow

enum<string>

required

Available options:

direct

businessInformation

object

required

Basic business information required for customer creation.

Conditional Field Requirements:

businessTradeName: Required when hasDBA is true
describeIndustry: Required when industry is Other
regulatorName, regulatoryLicenseNumber, hasIndependentAmlAuditReport: Required when isFinancialInstitution is true
regulatoryAuthorityOther: Required when regulatorName is Other
flowOfFundsDescription: Required when isFinancialInstitution is false
stockExchange and tickerSymbol: Required when isStockExchangeListed is true
stockExchangeOther: Required when stockExchange is Other
accountPurposeDescription: Required when accountPurpose is Payments for Goods or Services
highRiskIndustryDetails: Required when highRiskIndustry is not None
nestedFlowDescription: Required when hasNestedFlows is true
blockchainWallets: Required when usesBlockChainWallets is true
revenueCoverage: Required when isGeneratingRevenues is true
revenueCoverageExplanation: Required when revenueCoverage is Less than 25% of expenses
runwayDurationExplanation: Required when runwayDurationMonths is less than 12 months
deniedUsBankAccount: Required when hasUsBankAccount is false

See individual field descriptions for more details.

Show child attributes

Example:

{
  "hasDBA": false,
  "businessTradeName": "Acme Corp",
  "industry": "Forex/Currency Exchange Provider",
  "entityType": "Bank",
  "website": "https://acme.com",
  "registeredDate": "2024-01-01",
  "email": "contact@acme.com",
  "phone": "+1234567890",
  "taxIdentificationNumber": "123456789",
  "taxClassification": "LLC",
  "businessEntityId": "BE001",
  "naicsCode": "NAIS001",
  "isFinancialInstitution": false,
  "registeredAddress": {
    "streetLine1": "123 Business St",
    "streetLine2": "Suite 100",
    "city": "New York",
    "state": "NY",
    "postalCode": "10001",
    "country": "USA"
  },
  "operatingAddress": {
    "streetLine1": "456 Office Ave",
    "city": "New York",
    "state": "NY",
    "postalCode": "10002",
    "country": "USA"
  },
  "mailingAddress": {
    "streetLine1": "789 Mailing Rd",
    "city": "New York",
    "state": "NY",
    "postalCode": "10003",
    "country": "USA"
  },
  "isSubsidiary": false,
  "isOperating": true,
  "entityTaxedAs": "Corporation",
  "anticipatedMonthlyVolume": 100000,
  "expectedAverageDailyBalance": 250000,
  "regulatorName": "FinCEN (Financial Crimes Enforcement Network)",
  "regulatoryLicenseNumber": "FIN-2024-12345",
  "hasAdvisor": true,
  "businessDescription": "Provider of industrial widgets and services",
  "hasIndependentAmlAuditReport": {
    "answer": false,
    "explanation": "Our company was incorporated recently and is in the process of establishing formal compliance procedures.",
    "timeline": "We plan to engage an independent auditor within the next 6 months to conduct our first AML compliance audit."
  },
  "businessEntityType": "Corporation",
  "isStockExchangeListed": false,
  "accountPurpose": "Payroll/ Employee Payouts",
  "highRiskIndustry": "Third-party / OBO payments",
  "highRiskIndustryDetails": "We facilitate payments for gig economy platforms, primarily for food delivery and ride-sharing services.",
  "hasNestedFlows": true,
  "nestedFlowDescription": "We manage escrow accounts for multiple vendors and process vendor payouts on behalf of our platform customers.",
  "certifiesOwnTreasuryUse": true,
  "keyGeographicBusinessCountries": ["USA", "CAN"],
  "anticipatedTransactionsVolume": 1500,
  "usesBlockChainWallets": true,
  "blockchainWallets": [
    {
      "walletAddress": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "associatedPlatformType": "exchange",
      "associatedPlatformName": "Binance"
    },
    {
      "walletAddress": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
      "associatedPlatformType": "custodian",
      "associatedPlatformName": "Fireblocks"
    },
    {
      "walletAddress": "TNVp4w8jH8J9Z6G1B5Q4R8P7K6J5H3D2F1",
      "associatedPlatformType": "self_custodied",
      "associatedPlatformName": "Company Treasury Wallet"
    }
  ],
  "sourceOfFunds": "Venture Capital (VC)/Private Equity",
  "productsOrServices": [
    "Technology / SaaS Provider",
    "Sale of Goods / Non-Financial Services"
  ],
  "isGeneratingRevenues": true,
  "revenueCoverage": "More than 50% of expenses and growing",
  "hasInstitutionalInvestors": true,
  "runwayDurationMonths": "More than 12 months",
  "cashOnHandUsd": 500000,
  "flowOfFundsDescription": "Funds are collected from institutional clients via wire transfers, processed through our custody accounts, and disbursed to beneficiaries via ACH and wire transfers based on client instructions.",
  "termsOfServiceAcceptance": {
    "date": "2025-07-28",
    "ipAddress": "201.221.240.218",
    "isAuthenticated": true
  }
}

orgId

string

isSubsidiary

boolean

kybSetupBy

enum<string>

Available options:

client

Response

Customer created successfully

Option 1
Option 2

Customer creation response. Response shape depends on the onboardingFlow used in the request.

onboardingFlow

enum<string>

required

Available options:

kyb_link

kybLink

string

required

Minimum string length: 1

kybLinkExpiration

string<date-time>

required

string

required

A valid Customer ID

Pattern: ^cus_[a-zA-Z0-9]{27}$

Example:

"cus_2ofTA13AD0xBtbEvBl20aEb1hEu"

businessLegalName

string

required

Minimum string length: 1

List customers Get customer

⌘I

Overview

Constants

Accounts

Documents

Customers

Clients

Counterparties

Quotes

Transactions

Simulations

Webhooks

Authorizations

Body

Response