---
title: "Returns a list of persons for the specified merchant."
method: GET
path: "/related-people"
---

# Returns a list of persons for the specified merchant.

`GET /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

Returns a list of persons for the specified merchant.

## Query parameters

- `merchantId` string

## Response `200`

Successful operation

- object
  - `items` RelatedPerson[]
    - `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)