---
title: "Get Subscription by ID"
method: GET
path: "/v1/rebalancing/subscriptions/{subscription_id}"
tags: ["Rebalancing"]
---

# Get Subscription by ID

`GET /v1/rebalancing/subscriptions/{subscription_id}`

## Request

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

Get a subscription by its ID.

## Response `200`

The portfolio subscription

- PortfolioSubscription
  - `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.
- `404`: No subscription with this ID exists for your correspondent. Check the subscription ID 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)