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

# Get Premium Endpoints

`GET /v1/account/premium-endpoints`

## Request

- Base URL: `https://api.swarms.world`
- URL: `https://api.swarms.world/v1/account/premium-endpoints`
- Auth: none declared. Required headers: `x-api-key`

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

## Changes

- **2026-10-16** `500c79520e41`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/the-swarm-corporation/apis/swarms-api/changes/v1/account/premium-endpoints/get.md)

---

[API](https://skmtc.dev/the-swarm-corporation/apis/swarms-api.md) - [All operations](https://skmtc.dev/the-swarm-corporation/apis/swarms-api/llms.txt) - [OpenAPI document](https://skmtc.dev/the-swarm-corporation/apis/swarms-api/revisions/fca99f497199?raw)