Add Individual

Adds an individual to the corporate application. Not applicable for individual applications

SecurityOAuth2: OAuth2Flow
Request
path Parameters
id
required
string

Application ID

header Parameters
Authorization
string

OAuth bearer token (see authentication flows)

x-l2f-request-id
string

Optional Unique ID per request, useful for fault resolution/diagnosis and audit.

x-l2f-idempotency-id
string

Unique ID used to safely retry an operation. See idempotency section for more details.

Request Body schema: application/json
individual_type
required
Array of strings

Type of Individual (use individual for non corporate customers)

Items Enum: "INDIVIDUAL" "OFFICER" "BENEFICIAL_OWNER" "CONTROL_PERSON" "AUTHORIZED_PERSON"
first_name
required
string

First name

middle_name
string

Middle Name(s) (if present)

last_name
required
string

Last name

email_address
string

Email Address

object (mailing_address)

Mailing Address

telephone_number
string

Telephone Number

tax_reference_number
string

Tax reference number of the country (SSN, ITIN, SIN, National Insurance Number etc)

passport_number
string

Passport Number

nationality
string

Nationality (2 Digit ISO31661-Alpha2 Format - https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)

date_of_birth
string <date>

RFC3339 (YYYY-MM-DD) Date of Birth

percentage_ownership
integer <int32>

(Only where type is BENEFICIAL_OWNER) Percentage ownership of the corporation (0 to 100)

title
string

Example values CEO, COO, CFO, President, BenefitsAdministrationOfficer, CIO, VP, AVP, Treasurer, Secretary, Controller, Manager, Partner or Member.

us_residency_status
string

US Residency Status

Enum: "US_CITIZEN" "RESIDENT_ALIEN" "NON_RESIDENT_ALIEN"
Responses
200

Success

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Error

post/v1/applications/{id}/individual
Request samples
application/json
{
  • "individual_type": [
    ],
  • "first_name": "string",
  • "middle_name": "string",
  • "last_name": "string",
  • "email_address": "string",
  • "mailing_address": {
    },
  • "telephone_number": "string",
  • "tax_reference_number": "string",
  • "passport_number": "string",
  • "nationality": "string",
  • "date_of_birth": "2019-08-24",
  • "percentage_ownership": 0,
  • "title": "string",
  • "us_residency_status": "US_CITIZEN"
}
Response samples
application/json
{
  • "data": {
    }
}
© 2023 Layer2 Financial Inc. All Rights Reserved.