Activity and Renewals

Exported proxy lists are tied to subscription activity. A list can be generated at any time, but the proxy entries only authenticate while the underlying subscription can be used.

Active subscriptions

A subscription is usable when it is active in your account and has not been deleted or expired.

Use the Account API to check subscription status:

GET https://api.thunderproxy.com/v1/api/account?apiKey={apiKey}&activeOnly=true
Copy code

Each item includes:

Field	Meaning
active	Whether the subscription is currently active in the account.
expiresAt	Renewal or expiry date.
type	Product family, such as rotating-residential, rotating-datacenter, or static-isp.
dataLeft	Remaining usage for rotating products.
ips	Static ISP proxy count.

Exported lists

An exported list is a snapshot of generated proxy usernames and the current output format.

Changing settings later does not immediately invalidate older usernames. For rotating products, this means you can export one list for Germany, update the subscription to France, export again, and use both sets while the subscription remains active.

Store the exported list with the settings you used to generate it when you need reproducible jobs.

See Exported List Not Working when an imported list fails after settings, protocol, password, renewal, or quantity changes.

Renewals

Renewals extend subscription access. After a renewal, existing proxy credentials usually continue working, but you should re-export the list after material subscription changes such as quantity, plan type, or protocol changes.

If you rely on automation, poll the Account API and alert before expiresAt.

Auto top-up and usage

Rotating subscriptions can expose remaining usage through dataLeft. If usage reaches zero, proxy authentication or traffic may fail even if you still have an exported list.

For long-running integrations, check both:

• The subscription is active.
• There is enough remaining data for the job.

When to re-export

Re-export the list after:

• Changing country, state, or city.
• Switching between rotating and sticky mode.
• Changing the number of sticky sessions.
• Switching protocol between HTTP and SOCKS5.
• Renewing or changing a Static ISP subscription quantity.
• Updating dashboard export format.

Troubleshooting checklist

1. Confirm the subscription appears in the Account API.
2. Confirm active is true.
3. Confirm expiresAt is in the future.
4. For rotating products, confirm dataLeft is greater than zero.
5. Re-export the proxy list and retry with a fresh line.
6. If location targeting was recently changed, test with country=ANY.

If the proxy still fails, see Authentication Failed and Test a Proxy with cURL.