v1

latestOpenAPI 3.0.02026-07-247150151.6 KB
Beneficial owners

Create a beneficial owner

Creates a beneficial owner associated with a business

post/businesses/{business_id}/beneficial_owners

Path parameters

business_idstring required

Request body

dobstring string

Date of birth in YYYY-MM-DD format.

first_namestring required

First name.<br />Has a 1 to 20-character limit. Must start with an alphabet and may only contain alphabets, spaces, and apostrophes.

middle_namestring

Middle name.<br />Has a 20-character limit. Must start with an alphabet and may only contain alphabets, spaces, and apostrophes.

last_namestring required

Last name.<br />Has a 2 to 20-character limit. Must start with an alphabet and may only contain alphabets, spaces, and apostrophes.

Example request

{
  "dob": "1980-04-04",
  "first_name": "John",
  "middle_name": "O'Shea",
  "last_name": "Doe",
  "addresses": [
    {
      "street": "345 California Ave.",
      "street2": "Suit 600",
      "city": "San Francisco",
      "state": "CA",
      "zip_code": "12345-1234",
      "country": "US",
      "is_primary": true
    }
  ]
}

Response

Example response

first_namestring required
last_namestring required
dobstring required