Billing API

Invoices with their lines and PDFs, the wallet's history, and balance promo codes.

Everything your accountant asks for, without opening the dashboard: every invoice (top-ups, traffic, orders) with its lines, the same PDF the dashboard downloads, and the wallet history behind the balance.

Balance codes add money to the balance once per account. Discount codes are different: they are sent as promo_code with a purchase.

List transactions

GET/api/v1/transactions

The wallet's history, newest first. amount_usd is signed: top-ups, bonuses and refunds are positive, purchases negative. Only paid rows count in the balance; a pending top-up waits for the payment, a failed one never arrived.

Query parameters

Name	Type	Description
`type`	string	Only one kind. One of: `deposit`, `charge`, `refund`, `coupon`, `bonus`, `commission`, `adjustment`.
`limit`	integer	Page size. 1–100. Default `50`.
`offset`	integer	How many to skip. From 0. Default `0`.

Request

curl "https://aeonproxy.com/api/v1/transactions?limit=3" \
  -H "Authorization: Bearer $AEONPROXY_API_KEY"

import os
import requests

r = requests.get(
    "https://aeonproxy.com/api/v1/transactions?limit=3",
    headers={"Authorization": f"Bearer {os.environ['AEONPROXY_API_KEY']}"},
    timeout=30,
)
data = r.json()
if not r.ok:
    raise SystemExit(data["error"]["message"])
print(data)

// Node.js 18+, as an ES module (.mjs)
const res = await fetch("https://aeonproxy.com/api/v1/transactions?limit=3", {
  headers: {
    Authorization: `Bearer ${process.env.AEONPROXY_API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.message);
console.log(data);

<?php
$ch = curl_init('https://aeonproxy.com/api/v1/transactions?limit=3');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('AEONPROXY_API_KEY'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$data = json_decode($body, true);
if ($status >= 400) {
    fwrite(STDERR, $data['error']['message'] . PHP_EOL);
    exit(1);
}
print_r($data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest("GET", "https://aeonproxy.com/api/v1/transactions?limit=3", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("AEONPROXY_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status)
	fmt.Println(string(out))
}

// Java 11+: java Main.java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://aeonproxy.com/api/v1/transactions?limit=3"))
            .header("Authorization", "Bearer " + System.getenv("AEONPROXY_API_KEY"))
            .GET()
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

// .NET 6+ console app (top-level statements)
using System.Net.Http.Headers;

using var http = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://aeonproxy.com/api/v1/transactions?limit=3");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("AEONPROXY_API_KEY"));
var response = await http.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());

Response 200

{
  "count": 9,
  "limit": 3,
  "offset": 0,
  "results": [
    {
      "id": 3301,
      "type": "charge",
      "amount_usd": -29.9,
      "status": "paid",
      "method": "Wallet balance",
      "invoice_number": 101962,
      "created_at": "2026-10-24T17:03:12.000Z"
    },
    {
      "id": 3298,
      "type": "deposit",
      "amount_usd": 50,
      "status": "paid",
      "method": "Crypto",
      "invoice_number": 101960,
      "created_at": "2026-10-24T16:51:40.000Z"
    },
    {
      "id": 3297,
      "type": "coupon",
      "amount_usd": 5,
      "status": "paid",
      "method": "Coupon SPRING5",
      "invoice_number": null,
      "created_at": "2026-10-23T10:02:18.000Z"
    }
  ]
}

Errors

Status	Code	When
400	`invalid_parameter`	an unknown `type`

List invoices

GET/api/v1/invoices

Every invoice of the account, newest first: top-ups, traffic purchases and orders. type says which.

Query parameters

Name	Type	Description
`limit`	integer	Page size. 1–100. Default `50`.
`offset`	integer	How many to skip. From 0. Default `0`.

Request

curl "https://aeonproxy.com/api/v1/invoices?limit=1" \
  -H "Authorization: Bearer $AEONPROXY_API_KEY"

import os
import requests

r = requests.get(
    "https://aeonproxy.com/api/v1/invoices?limit=1",
    headers={"Authorization": f"Bearer {os.environ['AEONPROXY_API_KEY']}"},
    timeout=30,
)
data = r.json()
if not r.ok:
    raise SystemExit(data["error"]["message"])
print(data)

// Node.js 18+, as an ES module (.mjs)
const res = await fetch("https://aeonproxy.com/api/v1/invoices?limit=1", {
  headers: {
    Authorization: `Bearer ${process.env.AEONPROXY_API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.message);
console.log(data);

<?php
$ch = curl_init('https://aeonproxy.com/api/v1/invoices?limit=1');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('AEONPROXY_API_KEY'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$data = json_decode($body, true);
if ($status >= 400) {
    fwrite(STDERR, $data['error']['message'] . PHP_EOL);
    exit(1);
}
print_r($data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest("GET", "https://aeonproxy.com/api/v1/invoices?limit=1", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("AEONPROXY_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status)
	fmt.Println(string(out))
}

// Java 11+: java Main.java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://aeonproxy.com/api/v1/invoices?limit=1"))
            .header("Authorization", "Bearer " + System.getenv("AEONPROXY_API_KEY"))
            .GET()
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

// .NET 6+ console app (top-level statements)
using System.Net.Http.Headers;

using var http = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://aeonproxy.com/api/v1/invoices?limit=1");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("AEONPROXY_API_KEY"));
var response = await http.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());

Response 200

{
  "count": 6,
  "limit": 1,
  "offset": 0,
  "results": [
    {
      "number": 101962,
      "type": "traffic",
      "description": "Residential traffic · 10 GB",
      "items": [
        {
          "label": "10 GB × $2.99",
          "amount_usd": 29.9
        }
      ],
      "total_usd": 29.9,
      "status": "paid",
      "method": "Wallet balance",
      "issued_at": "2026-10-24T17:03:12.000Z",
      "order_id": 5120
    }
  ]
}

Get an invoice

GET/api/v1/invoices/{number}

One invoice with its lines, by its number.

Path parameters

Name	Type	Description
`number`required	integer	The invoice number.

Request

curl "https://aeonproxy.com/api/v1/invoices/101962" \
  -H "Authorization: Bearer $AEONPROXY_API_KEY"

import os
import requests

r = requests.get(
    "https://aeonproxy.com/api/v1/invoices/101962",
    headers={"Authorization": f"Bearer {os.environ['AEONPROXY_API_KEY']}"},
    timeout=30,
)
data = r.json()
if not r.ok:
    raise SystemExit(data["error"]["message"])
print(data)

// Node.js 18+, as an ES module (.mjs)
const res = await fetch("https://aeonproxy.com/api/v1/invoices/101962", {
  headers: {
    Authorization: `Bearer ${process.env.AEONPROXY_API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.message);
console.log(data);

<?php
$ch = curl_init('https://aeonproxy.com/api/v1/invoices/101962');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('AEONPROXY_API_KEY'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$data = json_decode($body, true);
if ($status >= 400) {
    fwrite(STDERR, $data['error']['message'] . PHP_EOL);
    exit(1);
}
print_r($data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest("GET", "https://aeonproxy.com/api/v1/invoices/101962", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("AEONPROXY_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status)
	fmt.Println(string(out))
}

// Java 11+: java Main.java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://aeonproxy.com/api/v1/invoices/101962"))
            .header("Authorization", "Bearer " + System.getenv("AEONPROXY_API_KEY"))
            .GET()
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

// .NET 6+ console app (top-level statements)
using System.Net.Http.Headers;

using var http = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://aeonproxy.com/api/v1/invoices/101962");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("AEONPROXY_API_KEY"));
var response = await http.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());

Response 200

{
  "number": 101962,
  "type": "traffic",
  "description": "Residential traffic · 10 GB",
  "items": [
    {
      "label": "10 GB × $2.99",
      "amount_usd": 29.9
    }
  ],
  "total_usd": 29.9,
  "status": "paid",
  "method": "Wallet balance",
  "issued_at": "2026-10-24T17:03:12.000Z",
  "order_id": 5120
}

Errors

Status	Code	When
404	`not_found`	no invoice with this number on your account

Download an invoice PDF

GET/api/v1/invoices/{number}/pdf

The invoice as a PDF file, the same document the dashboard downloads.

Path parameters

Name	Type	Description
`number`required	integer	The invoice number.

Request

curl "https://aeonproxy.com/api/v1/invoices/101962/pdf" \
  -H "Authorization: Bearer $AEONPROXY_API_KEY" \
  -o invoice-101962.pdf --fail

import os
import requests

r = requests.get(
    "https://aeonproxy.com/api/v1/invoices/101962/pdf",
    headers={"Authorization": f"Bearer {os.environ['AEONPROXY_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
with open("invoice-101962.pdf", "wb") as f:
    f.write(r.content)

// Node.js 18+, as an ES module (.mjs)
import { writeFile } from "node:fs/promises";

const res = await fetch("https://aeonproxy.com/api/v1/invoices/101962/pdf", {
  headers: {
    Authorization: `Bearer ${process.env.AEONPROXY_API_KEY}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
await writeFile("invoice-101962.pdf", Buffer.from(await res.arrayBuffer()));

<?php
$ch = curl_init('https://aeonproxy.com/api/v1/invoices/101962/pdf');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('AEONPROXY_API_KEY'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($status >= 400) {
    fwrite(STDERR, "HTTP $status" . PHP_EOL);
    exit(1);
}
file_put_contents('invoice-101962.pdf', $body);

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest("GET", "https://aeonproxy.com/api/v1/invoices/101962/pdf", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("AEONPROXY_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status)
	if res.StatusCode == http.StatusOK {
		if err := os.WriteFile("invoice-101962.pdf", out, 0o644); err != nil {
			panic(err)
		}
	}
}

// Java 11+: java Main.java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.file.Path;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://aeonproxy.com/api/v1/invoices/101962/pdf"))
            .header("Authorization", "Bearer " + System.getenv("AEONPROXY_API_KEY"))
            .GET()
            .build();
        HttpResponse<Path> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofFile(Path.of("invoice-101962.pdf")));
        System.out.println(response.statusCode());
    }
}

// .NET 6+ console app (top-level statements)
using System.Net.Http.Headers;

using var http = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://aeonproxy.com/api/v1/invoices/101962/pdf");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("AEONPROXY_API_KEY"));
var response = await http.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
if (response.IsSuccessStatusCode)
    await File.WriteAllBytesAsync("invoice-101962.pdf", await response.Content.ReadAsByteArrayAsync());

Response 200text/plain

%PDF-1.3 … (the file, application/pdf)

Errors

Status	Code	When
404	`not_found`	no invoice with this number on your account

Activate a balance code

POST/api/v1/promo-codes/activate

Adds a balance code's amount to the balance. Each code works once per account, and the account needs a confirmed email and a linked Telegram, as in the dashboard's Coupon page.

Body (JSON)

Name	Type	Description
`code`required	string	The code, in any letter case.

Request

curl -X POST "https://aeonproxy.com/api/v1/promo-codes/activate" \
  -H "Authorization: Bearer $AEONPROXY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code":"SPRING5"}'

import os
import requests

r = requests.post(
    "https://aeonproxy.com/api/v1/promo-codes/activate",
    headers={"Authorization": f"Bearer {os.environ['AEONPROXY_API_KEY']}"},
    json={"code": "SPRING5"},
    timeout=30,
)
data = r.json()
if not r.ok:
    raise SystemExit(data["error"]["message"])
print(data)

// Node.js 18+, as an ES module (.mjs)
const res = await fetch("https://aeonproxy.com/api/v1/promo-codes/activate", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.AEONPROXY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ code: "SPRING5" }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.message);
console.log(data);

<?php
$ch = curl_init('https://aeonproxy.com/api/v1/promo-codes/activate');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('AEONPROXY_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode(['code' => 'SPRING5']),
    CURLOPT_RETURNTRANSFER => true,
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$data = json_decode($body, true);
if ($status >= 400) {
    fwrite(STDERR, $data['error']['message'] . PHP_EOL);
    exit(1);
}
print_r($data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
	"strings"
)

func main() {
	body := strings.NewReader(`{"code":"SPRING5"}`)
	req, err := http.NewRequest("POST", "https://aeonproxy.com/api/v1/promo-codes/activate", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("AEONPROXY_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status)
	fmt.Println(string(out))
}

// Java 11+: java Main.java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://aeonproxy.com/api/v1/promo-codes/activate"))
            .header("Authorization", "Bearer " + System.getenv("AEONPROXY_API_KEY"))
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString("{\"code\":\"SPRING5\"}"))
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

// .NET 6+ console app (top-level statements)
using System.Net.Http.Headers;
using System.Text;

using var http = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://aeonproxy.com/api/v1/promo-codes/activate");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("AEONPROXY_API_KEY"));
request.Content = new StringContent("{\"code\":\"SPRING5\"}", Encoding.UTF8, "application/json");
var response = await http.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());

Response 200

{
  "code": "SPRING5",
  "credited_usd": 5,
  "balance_usd": 47.5
}

Errors

Status	Code	When
400	`invalid_request`	the code does not exist, has expired or was used, or Telegram is not linked yet

Your API key is already in the dashboard.

Create an account API overview

Billing API

List transactions

Query parameters

Request

Response 200

Errors

List invoices

Query parameters

Request

Response 200

Get an invoice

Path parameters

Request

Response 200

Errors

Download an invoice PDF

Path parameters

Request

Response 200text/plain

Errors

Activate a balance code

Body (JSON)

Request

Response 200

Errors

See also

Your API key is already in the dashboard.