---
title: "Buy a proxy (GB pack in a pool + country)"
method: POST
path: "/api/v1/proxies"
tags: ["Proxies"]
---

# Buy a proxy (GB pack in a pool + country)

`POST /api/v1/proxies`

## Request

- Base URL: `https://virtualsms.io`
- URL: `https://virtualsms.io/api/v1/proxies`
- Auth: API key in header `X-API-Key`

## Request body

- object
  - `pool_type` 'residential' | 'mobile' | 'datacenter', required
  - `gb` number, float, required
  - `country_code` string: Optional preferred country for sticky sessions
  - `idempotency_key` string: Optional; derived from request fields if omitted

## Response `201`

Proxy purchased — connection details returned once, store them

- object
  - `proxy_id` string
  - `proxy_host` string
  - `proxy_port` integer
  - `proxy_login` string
  - `proxy_password` string

## Other responses

- `402`: Insufficient balance

---

[API](https://skmtc.dev/virtualsms/apis/virtualsms-account-verification-platform-for-developers-and.md) · [All operations](https://skmtc.dev/virtualsms/apis/virtualsms-account-verification-platform-for-developers-and/llms.txt) · [OpenAPI document](https://skmtc.dev/virtualsms/apis/virtualsms-account-verification-platform-for-developers-and/revisions/be89af981be1?raw)