---
title: "List companions"
method: GET
path: "/api/persons/{personId}/companions"
tags: ["person-controller"]
---

# List companions

`GET /api/persons/{personId}/companions`

List companions from the repository.

## Path parameters

- `personId` string, required

## Query parameters

- `listTemp` boolean

## Response `200`

OK

- CompanionResponse[]
  - `createdDtm` TimestampRes
    - `date` integer
    - `day` integer
    - `hours` integer
    - `minutes` integer
    - `month` integer
    - `nanos` integer
    - `seconds` integer
    - `time` integer
    - `timezoneOffset` integer
    - `year` integer
  - `expiringDtm` TimestampRes
    - `date` integer
    - `day` integer
    - `hours` integer
    - `minutes` integer
    - `month` integer
    - `nanos` integer
    - `seconds` integer
    - `time` integer
    - `timezoneOffset` integer
    - `year` integer
  - `firstName` string — First name
  - `href` string — href
  - `id` string — ID
  - `lastName` string — lastName
  - `lastUpdatedDtm` TimestampRes
    - `date` integer
    - `day` integer
    - `hours` integer
    - `minutes` integer
    - `month` integer
    - `nanos` integer
    - `seconds` integer
    - `time` integer
    - `timezoneOffset` integer
    - `year` integer
  - `personId` string — personId
  - `privateInfo` PrivateInfo
    - `attributes` Attribute[]
      - `credentialAttributeName` string
      - `credentialAttributeValue` string
      - `credentialType` string

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Unexpected error in processing the request.

---

[API](https://skmtc.dev/myverifly/apis/api-documentation.md) · [All operations](https://skmtc.dev/myverifly/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/myverifly/api-documentation/revisions/03f300608c33/schema)