API Reference

LumaProxies API Docs

Full LumaProxies API reference with endpoint tabs, complete country coverage, and copy-ready examples.

Category

Quick Start

Base URL: https://lumaproxies.com

curl -X GET "https://lumaproxies.com/api/proxy/balance" \
  -H "Authorization: Bearer YOUR_API_KEY"

Country Coverage

Browse all available countries by plan type.

Plan Type

Search Country

Residential countries

135

  • AlbaniaAL
  • AlgeriaDZ
  • AngolaAO
  • ArgentinaAR
  • ArmeniaAM
  • AustraliaAU
  • AustriaAT
  • AzerbaijanAZ
  • BahrainBH
  • BarbadosBB
  • BelarusBY
  • BelgiumBE
  • BhutanBT
  • Bosnia and HerzegovinaBA
  • BoliviaBO
  • BotswanaBW
  • BrazilBR
  • BruneiBN
  • BulgariaBG
  • Burkina FasoBF
  • CambodiaKH
  • CameroonCM
  • CanadaCA
  • ChileCL
  • ColombiaCO
  • CongoCG
  • Costa RicaCR
  • Cote D'IvoireCI
  • CroatiaHR
  • CyprusCY
  • Dominican RepublicDO
  • EcuadorEC
  • EgyptEG
  • El SalvadorSV
  • EstoniaEE
  • EthiopiaET
  • Fiji IslandsFJ
  • FranceFR
  • GabonGA
  • GeorgiaGE
  • GermanyDE
  • GhanaGH
  • GreeceGR
  • GuatemalaGT
  • GuyanaGY
  • HondurasHN
  • Hong Kong ChinaHK
  • HungaryHU
  • IndiaIN
  • IndonesiaID
  • IranIR
  • IraqIQ
  • IrelandIE
  • IsraelIL
  • ItalyIT
  • JamaicaJM
  • JapanJP
  • JordanJO
  • KazakhstanKZ
  • KenyaKE
  • KosovoXK
  • KuwaitKW
  • KyrgyzstanKG
  • LaosLA
  • LatviaLV
  • LebanonLB
  • LibyaLY
  • LithuaniaLT
  • MacedoniaMK
  • MadagascarMG
  • MalaysiaMY
  • MaliML
  • MaltaMT
  • MauritiusMU
  • MexicoMX
  • MoldovaMD
  • MongoliaMN
  • MoroccoMA
  • MozambiqueMZ
  • MyanmarMM
  • NepalNP
  • NetherlandsNL
  • New ZealandNZ
  • NicaraguaNI
  • NigeriaNG
  • NorwayNO
  • OmanOM
  • PakistanPK
  • PalestinePS
  • PanamaPA
  • ParaguayPY
  • PeruPE
  • PolandPL
  • PortugalPT
  • Puerto RicoPR
  • QatarQA
  • ReunionRE
  • RomaniaRO
  • RussiaRU
  • RwandaRW
  • Saudi ArabiaSA
  • SenegalSN
  • SerbiaRS
  • SlovakiaSK
  • SloveniaSI
  • SomaliaSO
  • South AfricaZA
  • SpainES
  • Sri LankaLK
  • SwedenSE
  • SwitzerlandCH
  • SyriaSY
  • Taiwan ChinaTW
  • TajikistanTJ
  • TanzaniaTZ
  • ThailandTH
  • Czech RepublicCZ
  • BangladeshBD
  • PhilippinesPH
  • South KoreaKR
  • United Arab EmiratesAE
  • TogoTG
  • Trinidad and TobagoTT
  • TunisiaTN
  • TurkeyTR
  • UgandaUG
  • UkraineUA
  • United KingdomGB
  • United StatesUS
  • UruguayUY
  • UzbekistanUZ
  • VenezuelaVE
  • VietnamVN
  • ZambiaZM
  • ZimbabweZW

API Explorer

Switch endpoints from the left tabs on desktop or dropdown on mobile.

Endpoint

GET/api/proxy/balance

Get API Key Balance

Retrieve the current balance for the authenticated API key.

Authentication

Authorization: Bearer YOUR_API_KEY (or x-api-key).

Response

{
  "balance": 125.5
}

Auth + 401 Troubleshooting

If you see 401 Unauthorized, key type or header format usually does not match the route.

  • Normal routes (/api/proxy/*): use your account API key.
  • Reseller routes (/api/reseller/*): use your reseller API key.
  • Accepted headers: Authorization: Bearer ..., x-api-key, and reseller also x-reseller-api-key.