Complete Signup

post

https://api-{tenant}.stage2.tappbank.com/org/branches/private/v1/limited/individual/signup

Submits the individual's personal, employment, and financial activity information to
complete KYC verification. This is the most data-intensive step of the onboarding flow.

On success, the individual profile is created with a pending KYC status. The KYC
verification result is processed asynchronously by the BaaS provider.

Authentication: Requires the temporary access token from step 3.

Required fields summary:

Section	Required Fields
Personal	`dateOfBirth`, `socialSecurityNumber`, `usCitizenshipStatus`, `address`
W9	`w9.isSubjectToBackupWithholding`, `w9.accepted`, `w9.timestamp`
Employment	`employment.isCurrentlyEmployed`, `employment.annualIncome`
Transfer Activity	At minimum the `*Expected` boolean flags for each transfer type

Possible error codes:

Code	Status	Field	Description
`DAY_BEFORE_NOW_INVALID`	400	`dateOfBirth`	Date must be in the past
`SSN`	400	`socialSecurityNumber`	Must match `XXX-XX-XXXX`
`CITY_HAS_INVALID_FORMAT`	400	`address.city`	City contains invalid characters
`DECIMALFORMAT`	400	`employment.annualIncome`	Must be a decimal string, e.g. `"65000.00"`
`BAAS_ERROR_FIELD`	400	—	External KYC service rejected the submission
`ALREADY_SIGNED_UP`	400	—	Individual has already completed this step
`UNAUTHORIZED`	401	—	Missing or invalid token
`INAPPROPRIATE_RIGHT`	403	—	User role is not allowed to call this endpoint

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Completes registration by submitting the user's profile and identity verification data. This is the final onboarding step before the account is activated.

Path and verification type differ per user type:

Individual (KYC): POST /branches/private/v1/limited/individual/signup

Business Owner (KYB): POST /branches/private/v1/limited/businessowner/signup

Operator (KYC): POST /branches/private/v1/limited/operator/signup

The Try It panel uses the Individual path. Business Owner and Operator callers should substitute their respective path.

Body Params

Complete individual KYC information.

Complete KYC payload for individual user signup (step 9).

middleName

string

Optional middle name.

consent

string | null

Consent value. Pass null if not applicable.

taxIdentificationNumber

string

Tax identification number type (e.g. EIN).

isSameAddress

boolean

Whether the mailing address is the same as the primary address.

dateOfBirth

string

required

Date of birth in MM/DD/YYYY format. Must be a past date.

socialSecurityNumber

string

required

^\d{3}-\d{2}-\d{4}$

Social Security Number in XXX-XX-XXXX format.

usCitizenshipStatus

string

enum

required

US citizenship status. Use Other for any status not covered by the other values — provide details in usCitizenshipStatusDetails.

Allowed:

usCitizenshipStatusDetails

string

length ≤ 255

Free-text description of citizenship status. Provide when usCitizenshipStatus is Other.

address

object

required

Physical or mailing address.

mailingAddress

object

Optional mailing address if different from primary address.

object

required

W9 tax certification data. Display the terms from /w9/terms before collecting this.

employment

object

required

Current employment details and income sources.

transferActivity

object

required

Expected financial transaction activity for compliance purposes.

Responses

200KYC information submitted. Verification is now processing asynchronously.

400Validation error or KYC service rejection.

401Invalid or missing temporary access token.

403User role is not permitted to call this endpoint.