---
title: "Archive a Beneficial Owner"
method: POST
path: "/entity_beneficial_owners/{entity_beneficial_owner_id}/archive"
---

# Archive a Beneficial Owner

`POST /entity_beneficial_owners/{entity_beneficial_owner_id}/archive`

## Request

- Base URL: `https://api.increase.com`
- URL: `https://api.increase.com/entity_beneficial_owners/{entity_beneficial_owner_id}/archive`
- Auth: HTTP bearer

## Path parameters

- `entity_beneficial_owner_id` string, required: The identifier of the Beneficial Owner to archive.

## 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' | 'social_security_number_last4' | '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

## Changes

- **2026-09-18** `17aa1bcd9fae`: 1 warning
  - added the new `social_security_number_last4` enum value to the `individual/identification/anyOf[subschema #1: Beneficial Owner Individual Identification]/method` response property for the response status `200`
- **2026-07-13** `64a92a8cc343`: 4 info
  - added `subschema #8, subschema #10` to the `allOf[#/components/schemas/error]/` response property `anyOf` list for the response status `4XX`
  - added `subschema #8, subschema #10` to the `allOf[#/components/schemas/error]/` response property `anyOf` list for the response status `5XX`
  - removed `subschema #8, subschema #10` from the `allOf[#/components/schemas/error]/` response property `anyOf` list for the response status `4XX`
  - removed `subschema #8, subschema #10` from the `allOf[#/components/schemas/error]/` response property `anyOf` list for the response status `5XX`
- **2026-04-12** `e1702c4a3b65`: 3 breaking, 1 info
  - the `individual/identification` response's property type changed from `object` to no type for status `200`
  - removed the required property `individual/identification/method` from the response with the `200` status
  - removed the required property `individual/identification/number_last4` from the response with the `200` status
  - added `subschema #1: Beneficial Owner Individual Identification, subschema #2` to the `individual/identification` response property `anyOf` list for the response status `200`

[Operation history](https://skmtc.dev/increase/apis/increase-api-2/changes/entity_beneficial_owners/:entity_beneficial_owner_id/archive/post.md)

---

[API](https://skmtc.dev/increase/apis/increase-api-2.md) - [All operations](https://skmtc.dev/increase/apis/increase-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/increase/apis/increase-api-2/revisions/efeb9b9f8ecc?raw)