# Persons

The Persons API allows the creation and management of one or more persons for the purpose of verification for `Business` sub accounts. Recommended if you wish to implement verification programmatically for your sub accounts. This API cannot be accessed for `Individual` sub accounts.


## Creates a new person under the account, for verification of Businesses

 - [POST /accounts/{id}/persons](https://developer.ryftpay.com/documentation/api/reference/openapi/persons/personcreate.md): This is for creating persons under your or your sub accounts account, required for verification of businesses. The following limits apply: - Maximum of 9 persons - Maximum of 5 persons with a role of Director - Maximum of 4 persons with a role of UltimateBeneficialOwner - Maximum of 1 person with a role of BusinessContact

## Retrieves persons in sorted (by epoch) order

 - [GET /accounts/{id}/persons](https://developer.ryftpay.com/documentation/api/reference/openapi/persons/personlist.md): Retrieves a list of the persons you've created for one of your sub accounts They are returned in sorted (by epoch) order (default is newest first)

## Retrieve a person by Id

 - [GET /accounts/{id}/persons/{personId}](https://developer.ryftpay.com/documentation/api/reference/openapi/persons/persongetbyid.md): This is used to fetch a person by its unique Id

## Update a person by Id

 - [PATCH /accounts/{id}/persons/{personId}](https://developer.ryftpay.com/documentation/api/reference/openapi/persons/personupdatebyid.md): This is used to update an existing person

## Deletes a person by Id

 - [DELETE /accounts/{id}/persons/{personId}](https://developer.ryftpay.com/documentation/api/reference/openapi/persons/persondeletebyid.md): Deletes a person under the account. This will also delete any files currently attached to the person. Note that you can only delete a person if verification.status is NotRequired or Required