API Reference

LuminaProxy API Documentation

Integrate our premium proxy network into your applications with our simple and powerful API.

Quick Start

1

Get Your API Key

Create an API key from your dashboard

2

Configure Endpoint

Use the endpoint generator to customize your proxy

3

Make Requests

Start routing your traffic through our network

Authentication

Proxy Authentication

LuminaProxy uses username:password authentication for proxy connections. Your credentials include your username, password, and optional parameters for session control and geo-targeting.

Proxy Format
username-country-XX-session-XXXXX-sessTime-N:password@proxy.luminaproxy.com:31000

Username Parameters

  • country-XX - Target country (ISO code)
  • session-XXXXX - Session ID for sticky sessions
  • sessTime-N - Session duration in minutes

Connection Details

  • Host - proxy.luminaproxy.com
  • Port - 31000
  • Protocol - HTTP/HTTPS

Code Examples

bash
curl -x "http://USERNAME-country-US-session-abc123-sessTime-5:PASSWORD@proxy.luminaproxy.com:31000" \
     -k "https://httpbin.org/ip"

Geo-Targeting

Target specific countries by adding the -country-XX parameter to your username. Omit this parameter for global/auto-selected locations.

🇺🇸US

United States

🇬🇧GB

United Kingdom

🇩🇪DE

Germany

🇫🇷FR

France

🇨🇦CA

Canada

🇦🇺AU

Australia

🇯🇵JP

Japan

🇧🇷BR

Brazil

And 190+ more countries available

Session Management

Sticky Sessions

Maintain the same IP address across multiple requests by using session IDs. This is useful for login flows, shopping carts, and multi-step processes.

Session Parameters

  • session-XXXXX - Unique session identifier. Use any alphanumeric string.
  • sessTime-N - Session duration in minutes (1-60 minutes).

Example

bash
# Same IP for 10 minutes
username-country-US-session-mysession123-sessTime-10:password@proxy.luminaproxy.com:31000

REST API Endpoints

API Authentication

Use your API key in the X-API-Key header or as Authorization: ApiKey YOUR_KEY.

bash
curl -H "X-API-Key: lp_live_your_api_key_here" \
     https://api.luminaproxy.com/api/v1/account

Available Endpoints

GET/api/v1/account

Get your account information

GET/api/v1/balance

Get your current balance in bytes and GB

GET/api/v1/credentials

Get your proxy credentials (username, password, endpoint)

GET/api/v1/traffic?days=7

Get daily traffic statistics for the last N days

GET/api/v1/logs?limit=100&offset=0

Get recent request logs with pagination

Example Response

json
// GET /api/v1/balance
{
  "balance_bytes": 5368709120,
  "balance_gb": "5.0000",
  "currency": "bytes"
}

Ready to Get Started?

Create your API key and start integrating LuminaProxy today.

Create API KeyGenerate Endpoint