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

# Returns a list of companies for the specified merchant.

`GET /related-companies`

## Request

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

Returns a list of companies for the specified merchant.

## Query parameters

- `merchantId` string

## Response `200`

Successful operation

- object
  - `items` RelatedCompany[]
    - `id` string: The server-generated id of the company which was registered or returned. Used for identifying the company in other methods e.g. getRelatedCompany.
    - `roles` string[]: A list of roles that this company holds.
    - `name` string: The legal company name. Used for screening purposes by the PXP Financial Risk Team.
    - `incorporationAddress` 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).
    - `taxNumber` string: The taxpayer Identification Number (TIN) of the company. Used for screening purposes by the PXP Financial Risk Team.
    - `incorporationDate` string: The exact starting date of the corporation, as it appears on the company registry of the country of incorporation. Used for screening purposes by the PXP Financial Risk Team.
    - `incorporationNumber` string: The federal number assigned to the business in the company registry at the time of incorporation. Used for screening purposes by the PXP Financial Risk Team.
    - `shareOrOwnershipPercentage` number: A percentage amount that indicates the ownership participation of the person. Used for screening purposes 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)