---
title: "List the contacts starred by the calling agent"
method: GET
path: "/service_agents/contact_stars"
tags: ["Service Agent"]
---

# List the contacts starred by the calling agent

`GET /service_agents/contact_stars`

## Request

- Base URL: `https://api.voipbin.net/v1.0`
- URL: `https://api.voipbin.net/v1.0/service_agents/contact_stars`
- Auth: none declared
- TypeScript: <https://skmtc.dev/voipbin/apis/voipbin-api/docs/service_agents/contact_stars/get.ts> (a function with typed inputs; its response is checked against the schema)

The calling agent's stars, newest star first. Every item has `starred` set to true. Use it to
mark the starred contacts in a contact list or on a contact detail screen. To get the
starred contacts themselves in one call, use `GET /service_agents/contacts?starred=true`.
The page token is the `tm_create` of the last returned star. Stars of contacts that were
deleted are not returned.

## Query parameters

- `page_size` integer
- `page_token` string

## Response `200`

Successful response.

- object
  - `next_page_token` string: Cursor token for the next page of results. Pass this value as the page_token parameter in the next request.
  - `result` ContactManagerContactStar[]
    - `contact_id` string, uuid, required: The contact ID returned from GET /service_agents/contacts.
    - `starred` boolean, required: Whether the calling agent has starred the contact.
    - `tm_create` string, date-time: When the contact was starred. Absent when starred is false.

## Other responses

- `400`: Invalid request (INVALID_ARGUMENT).
- `401`: Authentication required (UNAUTHENTICATED).
- `403`: Insufficient permission (PERMISSION_DENIED).
- `500`: Internal error (INTERNAL).

## Changes

- **2026-11-02** `77a8b1190027`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/voipbin/apis/voipbin-api/changes/service_agents/contact_stars/get.md)

---

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