increase-test
POST/entities

Create an entity

Creates a legal entity that can own accounts, such as a person, corporation, joint account, trust, or government authority. Supply structure and the matching details object, such as corporation or natural_person; the required details depend on the selected structure.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

12 body fields

Entity creation details. structure is required, and the details object corresponding to the selected structure must be supplied.

corporationobjectoptional
Details of the corporation entity to create. Required if `structure` is equal to `corporation`.
descriptionstringoptional
The description you choose to give the entity.
government_authorityobjectoptional
Details of the Government Authority entity to create. Required if `structure` is equal to `government_authority`.
jointobjectoptional
Details of the joint entity to create. Required if `structure` is equal to `joint`.
natural_personobjectoptional
Details of the natural person entity to create. Required if `structure` is equal to `natural_person`. Natural people entities should be submitted with `social_security_number` or `individual_taxpayer_identification_number` identification methods.
risk_ratingobjectoptional
An assessment of the entity's potential risk of involvement in financial crimes, such as money laundering.
sole_proprietorshipobjectoptional
Details of the sole proprietorship entity to create. Required if `structure` is equal to `sole_proprietorship`.
structurestringrequired
The type of Entity to create.
Allowed:corporationnatural_personjointtrustgovernment_authoritysole_proprietorship
supplemental_documentsarray<object>optional
Additional documentation associated with the entity.
terms_agreementsarray<object>optional
The terms that the Entity agreed to. Not all programs are required to submit this data.
third_party_verificationobjectoptional
If you are using a third-party service for identity verification, you can use this field to associate this Entity with the identifier that represents them in that service.
trustobjectoptional
Details of the trust entity to create. Required if `structure` is equal to `trust`.

3 status codes
200Returns the created entity, including its identifier, legal structure, status, and entity details.
corporationobjectrequired
Details of the corporation entity. Will be present if `structure` is equal to `corporation`.
created_atstringrequired
The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the Entity was created.
creating_entity_onboarding_session_idstringrequired
The identifier of the Entity Onboarding Session that was used to create this Entity, if any.
descriptionstringrequired
The entity's description for display purposes.
details_confirmed_atstringrequired
The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the Entity's details were most recently confirmed.
government_authorityobjectrequired
Details of the government authority entity. Will be present if `structure` is equal to `government_authority`.
idstringrequired
The entity's identifier.
idempotency_keystringrequired
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).
jointobjectrequired
Details of the joint entity. Will be present if `structure` is equal to `joint`.
natural_personobjectrequired
Details of the natural person entity. Will be present if `structure` is equal to `natural_person`.
risk_ratingobjectrequired
An assessment of the entity’s potential risk of involvement in financial crimes, such as money laundering.
sole_proprietorshipobjectrequired
Details of the sole proprietorship entity. Will be present if `structure` is equal to `sole_proprietorship`.
statusstringrequired
The status of the entity.
Allowed:activearchiveddisabled
structurestringrequired
The entity's legal structure.
Allowed:corporationnatural_personjointtrustgovernment_authoritysole_proprietorship
supplemental_documentsarray<SupplementalDocument>required
Additional documentation associated with the entity. This is limited to the first 10 documents for an entity. If an entity has more than 10 documents, use the GET /entity_supplemental_documents list endpoint to retrieve them.
terms_agreementsarray<EntityTermsAgreementsElement>required
The terms that the Entity agreed to. Not all programs are required to submit this data.
third_party_verificationobjectrequired
If you are using a third-party service for identity verification, you can use this field to associate this Entity with the identifier that represents them in that service.
trustobjectrequired
Details of the trust entity. Will be present if `structure` is equal to `trust`.
typestringrequired
A constant representing the object's type. For this resource it will always be `entity`.
Allowed:entity
validationobjectrequired
The validation results for the entity. Learn more about [validations](/documentation/entity-validation).
4XXReturned when the request encounters a client-side error.
5XXReturned when the server encounters an error.

Error handling

structure is required and must be one of corporation, natural_person, joint, trust, government_authority, or sole_proprietorship. Provide the matching details object, which is required for the selected structure; required nested fields must also be present. For example, corporation requires a name, legal identifier, address, and beneficial owners, while natural_person requires a name, date of birth, address, and identification.