---
title: "Registers a new person related to a merchant."
method: POST
path: "/related-people"
---

# Registers a new person related to a merchant.

`POST /related-people`

## Request

- Base URL: `https://api.test.kalixa.com/payment-service/v6`
- URL: `https://api.test.kalixa.com/payment-service/v6/related-people`
- Auth: HTTP basic

Registers a new person related to a merchant.

## Request body

- NewRelatedPerson: Contains the data of the new related person.
  - `roles` string[], required: A list of roles the person holds. See https://developer.kalixa.com/v1.0/docs/mandatory-data-per-cdd-level#section-related-people for more information about conditionally mandatory parameters.
  - `firstname` string, required: The persons first name.
  - `lastname` string, required: The persons last name.
  - `address` Address: Contains the address of a merchant, person or company.
    - `street` string, required: The Street including housenumber, housename, etc.
    - `city` string, required: The name of the city.
    - `postalCode` string, required: The postal code of the address.
    - `country` string, required: The address country code as ISO 3166-1 alpha-2 (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
  - `phoneNumber` string: A landline or mobile number where the person can be contacted, including country prefix. Used for contacting this person by PXP Financial if necessary.
  - `dateOfBirth` string: The date of birth of the person. Used for screening purposes by the PXP Financial Risk Team.
  - `skypeName` string: The skype contact, if available. Used for contacting this person by PXP Financial if necessary.
  - `email` string: The persons valid email address. Used for contacting this person by PXP Financial if necessary.
  - `shareOrOwnershipPercentage` number: A percentage amount that indicates the ownership participation of the person. Used for screening purposes by the PXP Financial Risk Team.
  - `merchantId` string, required: The id of the merchant to which this contact relates to. Used for associating the contact with the merchant.
  - `passportOrGovernmentNumber` string: The unique identifier of the persons Passport or government number. Used for screening purposes by the PXP Financial Risk Team.
  - `passportOrGovernmentIDExpirationDate` string: The date when the passport or the government-ID expires. Used for screening purposes by the PXP Financial Risk Team.
  - `isListedOnPEP` boolean: The information if the related person is listed on PEP. PEP is short for 'politically exposed person', a natural person who is or who has been entrusted with prominent public functions. Used by the PXP Financial Risk Team.

## Response `201`

Successful operation

- RelatedPerson: Contains the person's data.
  - `id` string: The server-generated id of the person which was registered or returned. Used for identifying the person in other methods e.g. getRelatedPerson.
  - `roles` string[]: A list of roles the person holds. See https://developer.kalixa.com/v1.0/docs/mandatory-data-per-cdd-level#section-related-people for more information about conditionally mandatory parameters.
  - `firstname` string: The persons first name.
  - `lastname` string: The persons last name.
  - `address` Address: Contains the address of a merchant, person or company.
    - `street` string, required: The Street including housenumber, housename, etc.
    - `city` string, required: The name of the city.
    - `postalCode` string, required: The postal code of the address.
    - `country` string, required: The address country code as ISO 3166-1 alpha-2 (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
  - `phoneNumber` string: A landline or mobile number where the person can be contacted, including country prefix. Used for contacting this person by PXP Financial if necessary.
  - `dateOfBirth` string: The date of birth of the person. Used for screening purposes by the PXP Financial Risk Team.
  - `skypeName` string: The skype contact, if available. Used for contacting this person by PXP Financial if necessary.
  - `email` string: The persons valid email address. Used for contacting this person by PXP Financial if necessary.
  - `shareOrOwnershipPercentage` number: A percentage amount that indicates the ownership participation of the person. Used for screening purposes by the PXP Financial Risk Team.
  - `passportOrGovernmentNumber` string: The unique identifier of the persons Passport or government number. Used for screening purposes by the PXP Financial Risk Team.
  - `passportOrGovernmentIDExpirationDate` string: The date when the passport or the government-ID expires. Used for screening purposes by the PXP Financial Risk Team.
  - `isListedOnPEP` boolean: The information if the related person is listed on PEP. PEP is short for 'politically exposed person', a natural person who is or who has been entrusted with prominent public functions. Used by the PXP Financial Risk Team.
  - `merchant` ObjectWithId: Contains only the id of the resource. Used for future extensibility.
    - `id` string: The id of the resource.
  - `documents` ObjectWithId[]
    - `id` string: The id of the resource.

## Other responses

- `400`: Error occurred

---

[API](https://skmtc.dev/kalixa/apis/payment-service-v6-merchant-onboarding.md) - [All operations](https://skmtc.dev/kalixa/apis/payment-service-v6-merchant-onboarding/llms.txt) - [OpenAPI document](https://skmtc.dev/kalixa/apis/payment-service-v6-merchant-onboarding/revisions/066120f66046?raw)