Account API | Thunderproxy Docs

The Account API lets you view your account balance and list the subscriptions that belong to your account. Use it to discover subscription IDs, check whether subscriptions are active, and decide which subscription to use with the Subscription API.

Authentication

Use your subscription API key as the apiKey query parameter.

apiKey={subscriptionApiKey}

Get account

GET https://api.thunderproxy.com/v1/api/account?apiKey={apiKey}

Query parameters

Parameter	Default	Values
`page`	`1`	Any integer greater than `0`.
`size`	`50`	`10`, `25`, or `50`.
`activeOnly`	`false`	`true` or `false`.

Example

curl "https://api.thunderproxy.com/v1/api/account?apiKey=YOUR_API_KEY&activeOnly=true&size=25"

Response

Successful responses use the standard JSON envelope.

{
  "success": true,
  "data": {
    "account": {
      "balance": 42.5
    },
    "subscriptions": [
      {
        "id": "65f000000000000000000001",
        "active": true,
        "expiresAt": "2026-06-01T00:00:00.000Z",
        "type": "rotating-residential",
        "authUser": "customer-user",
        "dataLeft": 5368709120
      },
      {
        "id": "65f000000000000000000002",
        "active": true,
        "expiresAt": "2026-06-10T00:00:00.000Z",
        "type": "static-isp",
        "authUser": "customer-static",
        "ips": 10
      }
    ],
    "pagination": {
      "page": 1,
      "size": 25,
      "totalItems": 2,
      "totalPages": 1
    }
  }
}

Account fields

Field	Description
`balance`	Available account balance in USD for purchases.

Subscription fields

Field	Description
`id`	Subscription ID. Use this with Subscription API endpoints.
`active`	`true` when the subscription is not deleted.
`expiresAt`	Renewal or expiry date for the subscription.
`type`	Product slug, such as `rotating-residential`, `rotating-datacenter`, or `static-isp`.
`authUser`	Base proxy username for the subscription.
`dataLeft`	Remaining data for rotating residential and datacenter subscriptions.
`ips`	Number of static ISP proxies on a static ISP subscription.

Errors

Invalid query parameters return a 400 response.

{
  "success": false,
  "error": "Size must be one of 10, 25 or 50."
}

Missing or invalid API keys return an unauthorized response.

{
  "success": false,
  "error": "Unauthorized"
}

Typical workflow

Call the Account API to list active subscriptions.
Pick the subscription id and product type.
Use the Subscription API to update settings or export the proxy list for that subscription.