---
title: "Fetch pending subscription updates (polling)"
method: GET
path: "/api/v1/subscriptions/updates"
tags: ["Live-Subscriptions"]
---

# Fetch pending subscription updates (polling)

`GET /api/v1/subscriptions/updates`

## Request

- Base URL: `https://tradingstrategies.work`
- URL: `https://tradingstrategies.work/api/v1/subscriptions/updates`
- Auth: HTTP bearer

Returns all undelivered updates for the API key, then marks them as delivered. Call regularly to consume the polling queue. Idempotent — subsequent calls return remaining undelivered only. [API Pro tier]

## Response `200`

Pending updates.

- object
  - `updates` SubscriptionUpdate[]
    - `id` integer, required
    - `subscription_id` string, uuid, required
    - `subscription_type` 'signal_alert' | 'cycle_band' | 'pulse_score' | 'bullmarket_stage', required
    - `payload` object, required
    - `created_at` string, date-time, required
  - `tier` 'free' | 'api_pro' | 'api_power': Echo des aktuellen Tier des aufrufenden API-Keys.

## Other responses

- `400`: Invalid input — fehlt Pflichtfeld oder Wert außerhalb des erlaubten Bereichs.
- `401`: Unauthenticated — kein gültiger Bearer-Token im Authorization-Header.
- `403`: Tier-Insufficient — Endpoint braucht höheren API-Tier. Response enthält upgrade_url.
- `404`: Not-Found — Resource existiert nicht oder gehört nicht dem aktuellen User.
- `429`: Rate-Limit überschritten — Tier-Quota (hourly/daily) oder Per-Endpoint-Quota erreicht. Retry-After-Header gesetzt.
- `500`: Internal Error.
- `503`: Upstream-Failure — Datenquelle nicht erreichbar (Binance, EODHD, etc.).

---

[API](https://skmtc.dev/tradingstrategies/apis/backtesting-arena-public-api.md) · [All operations](https://skmtc.dev/tradingstrategies/apis/backtesting-arena-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tradingstrategies/apis/backtesting-arena-public-api/revisions/f82e8d6eecd7?raw)