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

# List associated persons

`GET /employees/{employee_id}/associated_persons`

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.

## Headers

- `X-Platform-Id` string

## 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

---

[API](https://skmtc.net/kota/apis/kota-api.md) · [All operations](https://skmtc.net/kota/apis/kota-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kota/kota-api/revisions/7b8b3ed87c96/schema)