---
title: "List associated persons"
method: GET
path: "/employees/{employee_id}/associated_persons"
tags: ["Associated Persons"]
---

# List associated persons

`GET /employees/{employee_id}/associated_persons`

## Request

- Base URL: `https://test.api.kota.io`
- URL: `https://test.api.kota.io/employees/{employee_id}/associated_persons`
- Auth: HTTP bearer

Returns a list of all `associated person`'s for a specific `employee`. The `associated person`'s are returned sorted by creation date, with the most recent `associated person` appearing first.

## Path parameters

- `employee_id` string, required

## Query parameters

- `page` integer: The page of results to return. Defaults to 1 if not provided.
- `page_size` integer: The number of results to return per page. Defaults to 10 if not provided. Maximum value is 100.

## Response `200`

OK

- AssociatedPersonResponsePagedList
  - `items` AssociatedPersonResponse[], required: A paginated array containing the response elements
    - `id` string, required: Unique identifier for the associated person
    - `platform_id` string: Unique identifier for the platform
    - `employee_id` string, required: Unique identifier for the employee this person is associated with
    - `first_name` string, required: First name of the associated person
    - `last_name` string, required: Last name of the associated person
    - `date_of_birth` string, date, required: Date of birth of the associated person
    - `sex_at_birth` 'male' | 'female', required
    - `relationship_type` 'spouse' | 'partner' | 'child' | 'other', required
    - `email` string, nullable: Email address of the associated person
    - `phone_number` string, nullable: Phone number in E.164 international format (e.g. +447700900999)
    - `object` string: The object type
  - `page` integer, required: The current page of the results
  - `page_size` integer, required: The number of results on this page. This can be different from the requested page size if the total number of results is less than the requested page size
  - `total_count` integer, required: The total number of elements available in the response. This is the total number of elements available across all pages, not just the current page.
  - `has_next_page` boolean: Whether there are more pages available after this page
  - `has_previous_page` boolean: Whether there are more pages available before this page

## Other responses

- `404`: Not Found

## Changes

- **2026-10-26** `998f7cb004ab`: 1 warning
  - deleted the `header` request parameter `X-Platform-Id`
- **2026-08-07** `7b8b3ed87c96`: 1 info
  - added the new optional `header` request parameter `X-Platform-Id`

[Operation history](https://skmtc.dev/kota/apis/kota-api/changes/employees/:employee_id/associated_persons/get.md)

---

[API](https://skmtc.dev/kota/apis/kota-api.md) - [All operations](https://skmtc.dev/kota/apis/kota-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kota/apis/kota-api/revisions/998f7cb004ab?raw)