---
title: "List stars"
method: GET
path: "/v1/stars"
tags: ["lookup"]
---

# List stars

`GET /v1/stars`

## Request

- Base URL: `https://sofiastage.com/api`
- URL: `https://sofiastage.com/api/v1/stars`
- Auth: none declared

## Query parameters

- `q` string
- `limit` integer
- `view` 'full' | 'summary'

## Response `200`

Stars with upcoming event counts

- union
  - StarListResponse
    - `data` StarItem[], required
      - `id` integer, required
      - `name` string, required
      - `occupation` string, nullable, required
      - `image_url` string, uri, nullable, required
      - `gallery_images` string[], required
      - `back_title` string, nullable, required
      - `back_text` string, nullable, required: Markdown biography shown on the reverse of the profile card.
      - `links` StarLink[], required
        - `platform` string, required
        - `url` string, uri, required
      - `profile_url` string, uri, nullable, required: Canonical SofiaStage star profile URL.
      - `profile_image_link` string, uri, nullable, required: Optional custom URL attached to the star profile image.
      - `upcoming_events_count` integer, required
  - StarSummaryListResponse
    - `data` StarSummaryItem[], required
      - `id` integer, required
      - `name` string, required
      - `occupation` string, nullable, required
      - `image_url` string, uri, nullable, required
      - `profile_url` string, uri, nullable, required
      - `profile_image_link` string, uri, nullable, required
      - `upcoming_events_count` integer, required

## Other responses

- `400`: Bad request
- `429`: Too many requests (retry with backoff)

---

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