---
title: "List proxy plans"
method: GET
path: "/proxy_plans"
tags: ["Plans"]
---

# List proxy plans

`GET /proxy_plans`

## Request

- Base URL: `https://dashboard.voidmob.com/api/v1`
- URL: `https://dashboard.voidmob.com/api/v1/proxy_plans`
- Auth: HTTP bearer

Returns active proxy plans with per-user quoted pricing. Plans
without a public id are filtered out.

Without `type`, only mobile/GB (`shared`) plans are returned and the
response has no `next_cursor` (the original response). With `type`,
Standard dedicated plans can be included, plans come back in a stable
order, and `next_cursor` pages through them. Premium dedicated plans
are never listed.

## Query parameters

- `type` 'shared' | 'dedicated_standard' | 'all'
- `country` string
- `min_gb` integer
- `period` 'daily' | 'weekly' | 'monthly'
- `limit` integer
- `available` boolean
- `cursor` string

## Response `200`

List of plans.

- object
  - `success` true, required
  - `data` object, required
    - `plans` ProxyPlan[], required
      - `id` string, required: Public plan identifier.
      - `name` string, required
      - `type` 'shared' | 'dedicated_standard', required
      - `country` string, nullable
      - `country_name` string, nullable
      - `carrier` string, nullable: Standard dedicated plans only. Mobile carrier of the modem.
      - `region` string, nullable: Standard dedicated plans only. Region the modem sits in; null if the plan takes any region.
      - `data_gb` integer, nullable, required: Null for dedicated plans (unmetered).
      - `duration_days` integer, required
      - `period` 'daily' | 'weekly' | 'monthly', required
      - `quoted_price_cents` integer, required: Price after your discount - what a purchase charges.
      - `available` boolean, required: Always true for mobile/GB plans. For a Standard dedicated plan, whether its own region has a modem free right now. Refreshes every 10 minutes; a purchase re-checks before charging.
    - `next_cursor` string, nullable: Present only when `type` was passed. Null on the last page.

## Other responses

- `400`: 400 - Request failed validation.
- `401`: 401 - Authentication required.
- `429`: 429 - Rate limit exceeded. Retry after the indicated interval.
- `500`: 500 - An unexpected error occurred. Please try again.

---

[API](https://skmtc.dev/voidmob/apis/voidmob-public-api.md) · [All operations](https://skmtc.dev/voidmob/apis/voidmob-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/voidmob/apis/voidmob-public-api/revisions/066023313ebe?raw)