API quickstart

This guide takes you from zero to a working integration: you’ll get your API key, verify it works, list your packages, and generate proxy lines you can plug straight into your HTTP client.

1. Get your API key

Log in to the dashboard.
Open API docs.
Copy your API key. It starts with fp_live_ and is shown only once — store it somewhere secure right away.

Treat your API key like a password. Don’t commit it to source control or embed it in client-side code. If a key leaks, rotate or revoke it from the dashboard.

2. Verify the key

Call GET /api/customer/balance. It’s a quick, read-only call that confirms your key works:

curl https://flameproxies.com/api/customer/balance \
  -H "Authorization: Bearer fp_live_xxx"

import requests

API_KEY = "fp_live_xxx"
BASE_URL = "https://flameproxies.com/api/customer"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get(f"{BASE_URL}/balance", headers=HEADERS)
resp.raise_for_status()
print(resp.json())

const API_KEY = "fp_live_xxx";
const BASE_URL = "https://flameproxies.com/api/customer";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };

const resp = await fetch(`${BASE_URL}/balance`, { headers: HEADERS });
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());

{
  "balance": 42.5,
  "currency": "USD",
  "data_balance_gb": 3
}

If you get an unauthorized error instead, check that the header is exactly Authorization: Bearer <key> and that the key hasn’t been revoked.

3. List your packages

curl https://flameproxies.com/api/customer/my-packages \
  -H "Authorization: Bearer fp_live_xxx"

resp = requests.get(f"{BASE_URL}/my-packages", headers=HEADERS)
resp.raise_for_status()

for pkg in resp.json()["packages"]:
    print(pkg["package_id"], pkg["plan"], pkg["username"])

const pkgResp = await fetch(`${BASE_URL}/my-packages`, { headers: HEADERS });
if (!pkgResp.ok) throw new Error(`HTTP ${pkgResp.status}`);

const { packages } = await pkgResp.json();
for (const pkg of packages) console.log(pkg.package_id, pkg.plan, pkg.username);

{
  "packages": [
    {
      "id": 123,
      "package_id": 123,
      "internal_id": "70437286-78a1-427c-b9fd-c299baadf3a9",
      "subuser_id": "56789",
      "plan": "premium_residential",
      "username": "fp-user",
      "created_at": "2026-05-13T12:00:00.000Z",
      "end_date": null,
      "is_primary": true,
      "api_created": true
    }
  ]
}

Grab the package_id of the package you want to use — you’ll need it in the next step.

4. Generate proxy lines

The generate endpoint builds proxy lines for you, with targeting and session parameters already encoded — no need to write the username format by hand. Generating proxies doesn’t cost anything.

curl https://flameproxies.com/api/customer/proxies/generate \
  -H "Authorization: Bearer fp_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"package_id":123,"quantity":10,"country":"US","proxy_type":"sticky","format":"http_url"}'

resp = requests.post(
    f"{BASE_URL}/proxies/generate",
    headers=HEADERS,
    json={
        "package_id": 123,
        "quantity": 10,
        "country": "US",
        "proxy_type": "sticky",
        "format": "http_url",
    },
)
resp.raise_for_status()
proxies = resp.json()["proxies"]
print(proxies[0])

const genResp = await fetch(`${BASE_URL}/proxies/generate`, {
  method: "POST",
  headers: { ...HEADERS, "Content-Type": "application/json" },
  body: JSON.stringify({
    package_id: 123,
    quantity: 10,
    country: "US",
    proxy_type: "sticky",
    format: "http_url",
  }),
});
if (!genResp.ok) throw new Error(`HTTP ${genResp.status}`);

const { proxies } = await genResp.json();
console.log(proxies[0]);

{
  "package_id": 123,
  "internal_id": "70437286-78a1-427c-b9fd-c299baadf3a9",
  "subuser_id": "56789",
  "plan": "residential",
  "count": 10,
  "proxies": [
    "http://username:password@proxy.flameproxies.com:8989"
  ]
}

5. Use them

Each line in proxies is a standard proxy URL. Pass it to any HTTP client:

curl -x "http://username:password@proxy.flameproxies.com:8989" https://ipinfo.io/json

proxy = proxies[0]
resp = requests.get("https://ipinfo.io/json", proxies={"http": proxy, "https": proxy})
print(resp.json())

You’re routed through a US residential IP. From here you can change the location, session length, pool, and modes with the same endpoint’s fields.

Next steps

Generate proxies

Every targeting, session, and format option.

Create an order

Create new packages from your wallet balance.

Error handling

Error codes and how to handle each one.

Rate limits

Stay under the limit and retry gracefully.

Getting Started

Proxies

Dashboard

API Reference

Code Examples

Troubleshooting

1. Get your API key

2. Verify the key

3. List your packages

4. Generate proxy lines

5. Use them

Next steps

Generate proxies

Create an order

Error handling

Rate limits

​1. Get your API key

​2. Verify the key

​3. List your packages

​4. Generate proxy lines

​5. Use them

​Next steps

Generate proxies

Create an order

Error handling

Rate limits

1. Get your API key

2. Verify the key

3. List your packages

4. Generate proxy lines

5. Use them

Next steps