Get a customer by ID - Conduit API

{ "id": "<string>", "applicationId": "<string>", "createdAt": "2026-01-15T09:30:00.000Z", "updatedAt": "2026-01-15T09:30:00.000Z", "features": [ { "feature": "VIRTUAL_ACCOUNT", "isActive": true } ], "customerType": "business", "legalName": "Acme Payments Inc.", "taxId": "12-3456789", "registeredCountry": "US", "registeredStreet1": "100 Market St", "registeredCity": "San Francisco", "dateOfIncorporation": "2020-03-15", "legalStructure": "Sociedade Limitada", "contactEmail": "compliance@acmepay.com", "clientReferenceId": "client-cus-001", "tradeName": "Acme Pay", "registrationNumber": "12345678", "registeredStreet2": "Suite 400", "registeredState": "CA", "registeredZipCode": "94105", "website": "https://acmepay.com", "coreIndustry": "Financial Technology", "contactPhone": "+14155551234" }

Authorizations

x-api-key

string

header

required

Path Parameters

string

required

Response

The requested customer

Option 1
Option 2

string

required

Unique customer identifier

Pattern: ^cus_[0-9A-Za-z]{22}$

applicationId

string

required

ID of the onboarding application that created this customer.

Pattern: ^app_[0-9A-Za-z]{22}$

createdAt

string<date-time>

required

Timestamp when the customer was created

Example:

"2026-01-15T09:30:00.000Z"

updatedAt

string<date-time>

required

Timestamp when the customer was last modified

Example:

"2026-01-15T09:30:00.000Z"

features

object[]

required

List of features enabled for this customer

Show child attributes

customerType

enum<string>

required

Available options:

business

legalName

string

required

Registered legal name of the business

Example:

"Acme Payments Inc."

taxId

string

required

Government-issued tax identifier (e.g. EIN for US businesses).

Example:

"12-3456789"

registeredCountry

enum<string>

required

Country of incorporation (ISO 3166-1 alpha-2)

Available options:

AF,

AL,

DZ,

AS,

AD,

AO,

AI,

AQ,

AG,

AR,

AM,

AW,

AU,

AT,

AZ,

BS,

BH,

BD,

BB,

BY,

BE,

BZ,

BJ,

BM,

BT,

BO,

BQ,

BA,

BW,

BV,

BR,

IO,

BN,

BG,

BF,

BI,

CV,

KH,

CM,

CA,

KY,

CF,

TD,

CL,

CN,

CX,

CC,

CO,

KM,

CG,

CD,

CK,

CR,

CI,

HR,

CU,

CW,

CY,

CZ,

DK,

DJ,

DM,

DO,

EC,

EG,

SV,

GQ,

ER,

EE,

SZ,

ET,

FK,

FO,

FJ,

FI,

FR,

GF,

PF,

TF,

GA,

GM,

GE,

DE,

GH,

GI,

GR,

GL,

GD,

GP,

GU,

GT,

GG,

GN,

GW,

GY,

HT,

HM,

VA,

HN,

HK,

HU,

IS,

IN,

ID,

IR,

IQ,

IE,

IM,

IL,

IT,

JM,

JP,

JE,

JO,

KZ,

KE,

KI,

KP,

KR,

KW,

KG,

LA,

LV,

LB,

LS,

LR,

LY,

LI,

LT,

LU,

MO,

MG,

MW,

MY,

MV,

ML,

MT,

MH,

MQ,

MR,

MU,

YT,

MX,

FM,

MD,

MC,

MN,

ME,

MS,

MA,

MZ,

MM,

NA,

NR,

NP,

NL,

NC,

NZ,

NI,

NE,

NG,

NU,

NF,

MK,

MP,

NO,

OM,

PK,

PW,

PS,

PA,

PG,

PY,

PE,

PH,

PN,

PL,

PT,

PR,

QA,

RE,

RO,

RU,

RW,

BL,

SH,

KN,

LC,

MF,

PM,

VC,

WS,

SM,

ST,

SA,

SN,

RS,

SC,

SL,

SG,

SX,

SK,

SI,

SB,

SO,

ZA,

GS,

SS,

ES,

LK,

SD,

SR,

SJ,

SE,

CH,

SY,

TW,

TJ,

TZ,

TH,

TL,

TG,

TK,

TO,

TT,

TN,

TR,

TM,

TC,

TV,

UG,

UA,

AE,

GB,

US,

UM,

UY,

UZ,

VU,

VE,

VN,

VG,

VI,

WF,

EH,

YE,

ZM,

ZW

Example:

"US"

registeredStreet1

string

required

Primary street address of registered office

Example:

"100 Market St"

registeredCity

string

required

City of registered office

Example:

"San Francisco"

dateOfIncorporation

string<date>

required

Date the business was incorporated (YYYY-MM-DD)

Pattern:

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$

Example:

"2020-03-15"

legalStructure

string

required

Legal structure of the business — the local jurisdiction name the customer declared at onboarding (e.g. 'Sociedade Limitada', 'GmbH', 'C-Corporation'). Free-form string; the available options are jurisdiction-specific and surfaced by the requirements discovery endpoint.

Example:

"Sociedade Limitada"

contactEmail

string

required

Primary business contact email

Example:

"compliance@acmepay.com"

clientReferenceId

string

Client-provided external identifier for cross-referencing

Pattern: ^[A-Za-z0-9_\-:.]{1,255}$

Example:

"client-cus-001"

tradeName

string

Doing-business-as name. Omitted if same as legal name.

Example:

"Acme Pay"

registrationNumber

string

Business registration or incorporation number

Example:

"12345678"

registeredStreet2

string

Secondary address line (suite, floor, etc.)

Example:

"Suite 400"

registeredState

string

State or province of registered office

Example:

"CA"

registeredZipCode

string

Postal code of registered office

Example:

"94105"

website

string

Business website URL

Example:

"https://acmepay.com"

coreIndustry

enum<string>

Primary industry classification of the business

Available options:

Agriculture,

Mining,

Manufacturing,

Retail/Wholesale,

Healthcare,

Real Estate,

Transport/Logistics,

Energy,

Education,

Financial Technology,

Professional Services,

Hospitality,

Construction,

Telecommunications,

Other

Example:

"Financial Technology"

contactPhone

string

Primary business contact phone number

Example:

"+14155551234"