HomeGuidesRecipesAPI ExplorerForumSupport
Partner Portal
Partner Portal

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-09-01' \
     -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}.