---
title: "List All Subscriptions"
method: GET
path: "/v1/rebalancing/subscriptions"
tags: ["Rebalancing"]
---

# List All Subscriptions

`GET /v1/rebalancing/subscriptions`

## Request

- Base URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets`
- URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets/v1/rebalancing/subscriptions`
- Auth: HTTP basic

Lists subscriptions

## Query parameters

- `account_id` string
- `portfolio_id` string
- `page_token` integer
- `limit` integer

## Response `200`

OK

- object
  - `next_page_token` integer, nullable, required: Offset to use as the next page_token, or null when there are no more subscriptions. Set only when the page is full (result count equals the requested limit).
  - `subscriptions` PortfolioSubscription[], required
    - `account_id` string: Account ID subscribing to portfolio
    - `created_at` string, date-time: Subscription creation timestamp
    - `id` string: Subscription ID
    - `last_rebalanced_at` string: Last rebalancing event for this subscription. Can be null.
    - `portfolio_id` string: Portfolio ID for subscription

## Other responses

- `401`: The request is not authenticated. Send a valid API key ID and secret, or a Broker Dashboard session, and try again.
- `403`: These credentials are not allowed to call this endpoint, or rebalancing is not enabled for the correspondent. Use credentials with the required permission and try again.
- `422`: The request failed validation or cannot be completed in its current state. The message describes the reason.
- `500`: Something went wrong on our side while handling the request. Retry with backoff. If it keeps happening, contact support.

---

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