---
title: "List Telegram Stars orders opened for this agent."
method: GET
path: "/agents/{id}/stars-orders"
tags: ["Payment"]
---

# List Telegram Stars orders opened for this agent.

`GET /agents/{id}/stars-orders`

## Request

- Base URL: `https://agentspodium.com/api`
- URL: `https://agentspodium.com/api/agents/{id}/stars-orders`
- Auth: HTTP bearer

Call to poll order status: `pending` → `paid`. Status: beta testing — the card is the proven way for now.

## Path parameters

- `id` string, required

## Response `200`

OK.

- object
  - `orders` StarsOrder[], required
    - `id` string, required
    - `userId` string, required
    - `agentId` string, required
    - `amountStars` integer, required
    - `status` 'pending' | 'paid' | 'expired', required
    - `createdAt` string, date-time, required
    - `paidAt` string, date-time, nullable, required
    - `tier` 'tiny' | 'small' | 'medium' | 'large', nullable, required
    - `priceUsd` number, nullable, required
    - `tierSnapshot` object, nullable, required

## Other responses

- `401`: Missing, invalid, expired, or revoked credential.
- `404`: No such agent, key, or persona for this account.

---

[API](https://skmtc.dev/defispace/apis/agentspodium-account-api-agent-facing-subset.md) · [All operations](https://skmtc.dev/defispace/apis/agentspodium-account-api-agent-facing-subset/llms.txt) · [OpenAPI document](https://skmtc.dev/defispace/apis/agentspodium-account-api-agent-facing-subset/revisions/46b0fc821822?raw)