---
title: "Get Premium Endpoints"
method: GET
path: "/v1/account/premium-endpoints"
tags: ["Account Management"]
---

# Get Premium Endpoints

`GET /v1/account/premium-endpoints`

Retrieve all API endpoints that require a premium subscription.

## Headers

- `x-api-key` string, required

## Response `200`

Successful Response

- PremiumEndpointsOutput — Response model listing every endpoint that requires a premium subscription. Attributes: status (bool): Indicates success of the operation. timestamp (str): The ISO formatted timestamp of the response. total (int): Number of premium endpoints. premium_endpoints (List[PremiumEndpointInfo]): Route, name and description for every premium-only endpoint. upgrade_url (str): Where to upgrade to a premium subscription.
  - `status` boolean — Indicates whether fetching premium endpoints was successful.
  - `timestamp` string, nullable — The ISO formatted timestamp when this response was generated.
  - `total` integer, required — Number of premium endpoints.
  - `premium_endpoints` PremiumEndpointInfo[], required — Route, name and description for every premium-only endpoint.
    - `route` string, required — The API route path that requires a premium subscription.
    - `name` string, required — Human-readable feature name for the endpoint.
    - `description` string, required — What the endpoint allows a premium subscriber to do.
  - `upgrade_url` string — Where to upgrade to a premium subscription.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/swarms/apis/swarms-api.md) · [All operations](https://skmtc.net/swarms/apis/swarms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/swarms/swarms-api/revisions/e17a6c8f9e59/schema)