# Return All Key Party Records Linked To A Profile

This endpoint will return all created Key Party folders linked to the profile id.

Endpoint: GET /compliance/kyc-protect/profiles/{profileId}/keyparties
Version: 1.10.9
Security: bearerToken

## Path parameters:

  - `profileId` (string, required)
    Id of the profile

## Query parameters:

  - `entityType` (string)
    Entity type of the key party. Available values are individual, business.

  - `keyPartyTypes` (string)
    Type of the key party. Available values are director, shareholder and ubo.

  - `page` (integer)
    Starting page number.

  - `pageSize` (integer)
    Number of items to return per Page.

## Response 200 fields (application/json):

  - `items` (array)

  - `items.id` (string)
    Id of the key party

  - `items.name` (string)
    Name of the key party

  - `items.firstName` (string)
    First name of the key party

  - `items.middleName` (string,null)
    Middle name of the key party

  - `items.lastName` (string)
    Last name of the key party

  - `items.entityType` (string)
    Entity type of the key party. Avaialable values are individual and business.

  - `items.keyPartyType` (string)
    Type of the key party. Available values are director, shareHolder and ubo.

  - `items.gender` (string,null)
    Gender of the key party. Available values are male and female.

  - `items.dateOfBirth` (string,null)
    Date of birth of the key party

  - `items.organisationNumber` (string,null)
    Key party organization number

  - `items.activityCode` (string,null)
    Activity code of the key party

  - `items.percentageOfShares` (number,null)
    Share percentage of the key party

  - `items.role` (string,null)
    Role of the key party

  - `items.countryCode` (string,null)
    Country code of the key party

  - `items.address` (object)

  - `items.address.id` (string)
    Id of the address

  - `items.address.buildingDetails` (string,null)
    Building details of the address

  - `items.address.street` (string,null)
    Street of the address

  - `items.address.city` (string,null)
    City of the address

  - `items.address.region` (string,null)
    Region of the address

  - `items.address.postalCode` (string,null)
    Postalcode of the address

  - `items.address.countryCode` (string,null)
    Two-letter country code ISO-3166-2

  - `items.address.type` (string)
    Type of the address. Available values are registered, trading and other.

  - `items.address.description` (string,null)
    Description of the address

  - `items.address.createdAt` (string)
    Address created date time

  - `items.address.createdById` (integer)
    Id of the user who created the Address

  - `items.address.createdBy` (string)
    Name of the user who created the Address

  - `items.address.modifiedAt` (string,null)
    Address last updated date time

  - `items.address.modifiedById` (integer,null)
    Id of the user who last modified the Address

  - `items.address.modifiedBy` (string,null)
    Name of the user who last modified the Address

  - `items.searchId` (string,null)
    Search Id of the key party

  - `items.createdAt` (string)
    Key party created time

  - `items.createdById` (integer)
    Id of the user who created the key party

  - `items.createdBy` (string)
    Name of the user who created the key party

  - `items.modifiedAt` (string,null)
    key party last updated time

  - `items.modifiedById` (integer,null)
    Id of the user who last modified the key party

  - `items.modifiedBy` (string,null)
    Name of the user who last modified the key party

  - `totalSize` (integer)

## Response 400 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected

## Response 401 fields (application/json):

  - `error` (string)

## Response 403 fields (application/json):

  - `message` (string)
    Example: "Access forbidden"

## Response 404 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected