---
title: "Get contacts"
method: GET
path: "/public/v2/contacts"
tags: ["Contacts"]
---

# Get contacts

`GET /public/v2/contacts`

## Request

- Base URL: `https://starlink.com/api`
- URL: `https://starlink.com/api/public/v2/contacts`
- Auth: HTTP bearer

Required permission: User management, View.<br/>Get list of contacts on this account.

## Query parameters

- `page` integer

## Response `200`

Contacts retrieved.

- UserResponsePaginatedServiceResponse
  - `errors` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `warnings` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `information` string[], nullable
  - `isValid` boolean
  - `content` UserResponsePaginated
    - `pageIndex` integer
    - `limit` integer
    - `isLastPage` boolean
    - `results` UserResponse[], nullable
      - `subjectId` string, required: Unique subject ID given to this user.
      - `email` string, required: User email.
      - `roles` string[], required: List of User roles which map to permissions on the specified account.
    - `totalCount` integer

## Other responses

- `400`: Bad request. Invalid or missing parameter
- `401`: Unauthorized
- `403`: user_lacks_required_permission
- `422`: Failed to retrieve contacts.
- `default`: Error

## Changes

- **2026-11-02** `dfd7014cfd6d`: 8 warning
  - added the new `2.00` enum value to the `content/requiredPermission/permission` response property for the response status `403`
  - added the new `24.00` enum value to the `content/requiredPermission/featureAccess` response property for the response status `403`
  - added the new `25.00` enum value to the `content/requiredPermission/featureAccess` response property for the response status `403`
  - added the new `3.00` enum value to the `content/requiredPermission/permission` response property for the response status `403`
  - …4 more

[Operation history](https://skmtc.dev/starlink/apis/starlink-management-api/changes/public/v2/contacts/get.md)

---

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