Manage persons

Learn how to manage the persons responsible for the organization entities.

Overview

Entities of type organization can have responsible persons' information associated with them.

Add a person to an entity

To add a person to an entity, call POST /entities/{entity_id}/persons:

curl -X POST 'https://api.sandbox.monite.com/v1/entities/{entity_id}/persons' \
     -H 'X-Monite-Version: 2023-03-14' \
     -H 'Authorization: Bearer ACCESS_TOKEN' \
     -H 'Content-Type: application/json' \
     -d '{
       "address": {
         "country": "DE",
         "line1": "Flughafenstrasse 52",
         "line2": "Additional information",
         "postal_code": "10115",
         "city": "Berlin",
         "state": "BE"
       },
       "date_of_birth": "1993-03-14",
       "first_name": "Mary",
       "last_name": "O Brien",
       "email": "[email protected]",
       "phone": "5551235476",
       "relationship": {
         "title": "CEO",
         "representative": false,
         "executive": true,
         "director": false,
         "owner": false,
         "percent_ownership": 10
       },
       "id_number": "NL000099998B57",
       "ssn_last_4": "0001"
     }'
  • An entity can have only one relationship.representative.
  • id_number is an optional field required only for NL onboarding for payment acceptance.
  • ssn_last_4 is an optional field required only for US onboarding for payment acceptance

The successful response returns the information about the person:

{
  "address": {
    "country": "DE",
    "line1": "Flughafenstrasse 52",
    "line2": "Additional information",
    "postal_code": "10115",
    "city": "Berlin",
    "state": "BE"
  },
  "date_of_birth": "1993-03-14",
  "first_name": "Mary",
  "last_name": "O Brien",
  "email": "[email protected]",
  "phone": "5551235476",
  "relationship": {
    "title": "CEO",
    "representative": false,
    "executive": true,
    "director": false,
    "owner": false,
    "percent_ownership": 10
  },
  "id_number": "NL000099998B57",
  "ssn_last_4": "0001",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "created_at": "2023-03-14T15:08:12.037Z",
  "updated_at": "2023-03-14T15:08:12.037Z"
}

List all persons

To get information about all persons associated with the specified entity, call
GET /entities/{entity_id}/persons.

Retrieve a person

To get information about a specific person associated with the specified entity, call
GET /entities/{entity_id}/persons/{person_id}.

Edit a person

To edit an existing person of the specified entity, call
PATCH /entities/{entity_id}/persons/{person_id}.

Delete a person

To delete an existing person from the list of persons associated with the specified entity, call
DELETE /entities/{entity_id}/persons/{person_id}.