---
title: "Retrieve a list of insured persons that are accessible with the presented access token"
method: GET
path: "/insured-persons"
tags: ["person"]
---

# Retrieve a list of insured persons that are accessible with the presented access token

`GET /insured-persons`

Returns the list of person identifier(s) (`personId`) that the authenticated user can access via the API.

A valid OAuth2 access token, obtained through a user consent flow, is required. No specific scope is enforced
for this endpoint, but the presence of a valid consent is mandatory.

The returned list acts as a mapping between the authenticated user (represented by the access token) and the
insured persons that are technically accessible through this API. The service provider MUST ensure that
only those person IDs are returned which are both:

1. authorized for the user in the provider’s system, AND
2. explicitly permitted for API access under the user’s current consent.

This prevents exposing additional person IDs that the user might be entitled to in the backend but which are
not covered by the API consent agreement.

In most cases, only a single `personId` will be returned. Multiple person IDs MAY be returned if the user is
authorized and has consented to access data for more than one insured person. If no accessible persons remain
under the current consent, the endpoint returns an empty list.

## Response `200`

A list of insured persons.

- object[]
  - `personId` string, required — Technical ID of insured person used in API calls.

## Other responses

- `400` — Some of the input is incomplete or invalid for starting a request.
- `401` — Access token is missing or invalid.
- `404` — Invalid ID / no authorization to access data.
- `500` — Internal Server Error - The server encountered an unexpected condition that prevented it from fulfilling the request.

---

[API](https://skmtc.net/swissfintechinnovations/apis/pension-2.md) · [All operations](https://skmtc.net/swissfintechinnovations/apis/pension-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/swissfintechinnovations/pension-2/revisions/ce7234453575/schema)