---
title: "Get a GB pool"
method: GET
path: "/proxy_pools/{id}"
tags: ["Proxy pools"]
---

# Get a GB pool

`GET /proxy_pools/{id}`

## Request

- Base URL: `https://dashboard.voidmob.com/api/v1`
- URL: `https://dashboard.voidmob.com/api/v1/proxy_pools/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required: Opaque reseller GB pool identifier.

## Response `200`

The pool.

- object
  - `success` true, required
  - `data` object, required
    - `pool` ProxyPool, required
      - `id` string, required: Opaque reseller GB pool identifier.
      - `name` string, required
      - `total_gb` number, required: Lifetime GB purchased, including every extension.
      - `allocated_gb` number, required: GB currently held by live sub-orders.
      - `remaining_gb` number, required: total_gb minus allocated_gb. Includes frozen GB while lapsed.
      - `price_per_gb_cents` integer, required: Current per-GB rate charged on every self-serve extension. Set with you when the pool is provisioned; renegotiated rates apply to later extensions only.
      - `valid_until` string, date-time, required
      - `status` 'active' | 'lapsed', required
      - `self_extend` object, required
        - `enabled` boolean, required: Whether POST /v1/proxy_pools/{id}/extend is allowed self-serve on this pool.
        - `min_gb` integer, required: Minimum gb accepted per self-serve extension.
        - `adds_days` integer, required: Days added to valid_until per extension.
      - `created_at` string, date-time, required

## Other responses

- `401`: 401 - Authentication required.
- `404`: 404 - Pool not found.
- `429`: 429 - Rate limit exceeded. Retry after the indicated interval.

---

[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)