--- title: "Create a Beneficial Owner" method: POST path: "/entity_beneficial_owners" --- # Create a Beneficial Owner `POST /entity_beneficial_owners` ## Request body - CreateABeneficialOwnerParameters - `company_title` string — This person's role or title within the entity. - `entity_id` string, required — The identifier of the Entity to associate with the new Beneficial Owner. - `individual` object, required — Personal details for the beneficial owner. - `address` object, required — The individual's physical address. Mail receiving locations like PO Boxes and PMB's are disallowed. - `city` string, required — The city, district, town, or village of the address. - `country` string, required — The two-letter ISO 3166-1 alpha-2 code for the country of the address. - `line1` string, required — The first line of the address. This is usually the street number and street. - `line2` string — The second line of the address. This might be the floor or room number. - `state` string — The two-letter United States Postal Service (USPS) abbreviation for the US state, province, or region of the address. Required in certain countries. - `zip` string — The ZIP or postal code of the address. Required in certain countries. - `confirmed_no_us_tax_id` boolean — The identification method for an individual can only be a passport, driver's license, or other document if you've confirmed the individual does not have a US tax id (either a Social Security Number or Individual Taxpayer Identification Number). - `date_of_birth` string, date, required — The person's date of birth in YYYY-MM-DD format. - `identification` object, required — A means of verifying the person's identity. - `drivers_license` object — Information about the United States driver's license used for identification. Required if `method` is equal to `drivers_license`. - `back_file_id` string — The identifier of the File containing the back of the driver's license. - `expiration_date` string, date, required — The driver's license's expiration date in YYYY-MM-DD format. - `file_id` string, required — The identifier of the File containing the front of the driver's license. - `state` string, required — The state that issued the provided driver's license. - `method` 'social_security_number' | 'individual_taxpayer_identification_number' | 'passport' | 'drivers_license' | 'other', required — A method that can be used to verify the individual's identity. - `number` string, required — An identification number that can be used to verify the individual's identity, such as a social security number. For Social Security Numbers and Individual Taxpayer Identification Numbers, submit nine digits with no dashes or other separators. - `other` object — Information about the identification document provided. Required if `method` is equal to `other`. - `back_file_id` string — The identifier of the File containing the back of the document. Not every document has a reverse side. - `country` string, required — The two-character ISO 3166-1 code representing the country that issued the document (e.g., `US`). - `description` string, required — A description of the document submitted. - `expiration_date` string, date — The document's expiration date in YYYY-MM-DD format. - `file_id` string, required — The identifier of the File containing the front of the document. - `passport` object — Information about the passport used for identification. Required if `method` is equal to `passport`. - `country` string, required — The two-character ISO 3166-1 code representing the country that issued the document (e.g., `US`). - `expiration_date` string, date, required — The passport's expiration date in YYYY-MM-DD format. - `file_id` string, required — The identifier of the File containing the passport. - `name` string, required — The person's legal name. - `prongs` string[], required — Why this person is considered a beneficial owner of the entity. At least one option is required, if a person is both a control person and owner, submit an array containing both. ## Response `200` Beneficial Owner - EntityBeneficialOwner — Beneficial owners are the individuals who control or own 25% or more of a `corporation` entity. Beneficial owners are always people, and never organizations. Generally, you will need to submit between 1 and 5 beneficial owners for every `corporation` entity. You should update and archive beneficial owners for a corporation entity as their details change. - `company_title` string, nullable, required — This person's role or title within the entity. - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the Beneficial Owner was created. - `entity_id` string, required — The identifier of the Entity to which this beneficial owner belongs. - `id` string, required — The identifier of this beneficial owner. - `idempotency_key` string, nullable, required — The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys). - `individual` object, required — Personal details for the beneficial owner. - `address` object, required — The person's address. - `city` string, nullable, required — The city, district, town, or village of the address. - `country` string, required — The two-letter ISO 3166-1 alpha-2 code for the country of the address. - `line1` string, required — The first line of the address. - `line2` string, nullable, required — The second line of the address. - `state` string, nullable, required — The two-letter United States Postal Service (USPS) abbreviation for the US state, province, or region of the address. - `zip` string, nullable, required — The ZIP or postal code of the address. - `date_of_birth` string, date, required — The person's date of birth in YYYY-MM-DD format. - `identification` object, nullable, required — A means of verifying the person's identity. - `method` 'social_security_number' | 'individual_taxpayer_identification_number' | 'passport' | 'drivers_license' | 'other', required — A method that can be used to verify the individual's identity. - `number_last4` string, required — The last 4 digits of the identification number that can be used to verify the individual's identity. - `name` string, required — The person's legal name. - `prongs` string[], required — Why this person is considered a beneficial owner of the entity. - `type` 'entity_beneficial_owner', required — A constant representing the object's type. For this resource it will always be `entity_beneficial_owner`. ## Other responses - `4XX` — Error - `5XX` — Error --- [API](https://skmtc.net/increase/apis/increase-api.md) · [All operations](https://skmtc.net/increase/apis/increase-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/increase/increase-api/versions/22125d715935/schema)