HTTP API

curl -X POST https://api.anyanalytics.org/v1/batch \
  -H "Authorization: Bearer vxw_YOUR_WRITE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"batch":[{"uuid":"'"$(uuidgen | tr A-Z a-z)"'","event":"$session_start","distinct_id":"user_123","session_id":"s_1","context":{"platform":"custom","app_version":"1.0.0"}}]}'

{
  "sent_at": "2026-05-04T10:15:02.120Z",
  "batch": [
    {
      "uuid": "0196a3c2-5b1e-7c4a-9f10-2b6d8e4a1c37",
      "event": "level_completed",
      "distinct_id": "player_8f2c",
      "session_id": "s_20260504_1",
      "timestamp": "2026-05-04T10:14:58.900Z",
      "properties": { "level": 5, "score": 1200 },
      "context": { "platform": "windows", "app_version": "1.4.0" }
    }
  ]
}

curl -X POST https://api.anyanalytics.org/v1/batch \
  -H "Authorization: Bearer vxw_YOUR_WRITE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"batch":[{"uuid":"'"$(uuidgen | tr A-Z a-z)"'","event":"signup","distinct_id":"user_123","properties":{"plan":"pro","source":"pricing_page"}}]}'

curl -X POST https://api.anyanalytics.org/v1/batch \
  -H "Authorization: Bearer vxw_YOUR_WRITE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"batch":[{"uuid":"'"$(uuidgen | tr A-Z a-z)"'","event":"$identify","distinct_id":"user_123","properties":{"$anon_distinct_id":"anon_456","$set":{"email":"[email protected]"}}}]}'

gzip -c events.json | curl -X POST https://api.anyanalytics.org/v1/batch \
  -H "Authorization: Bearer vxw_YOUR_WRITE_KEY" \
  -H "Content-Type: application/json" \
  -H "Content-Encoding: gzip" \
  --data-binary @-

{
  "accepted": 1,
  "duplicates": 0,
  "rejected": [],
  "filtered": 0
}

{
  "accepted": 1,
  "duplicates": 0,
  "rejected": [
    { "index": 1, "uuid": "0196a3c2-5b20-7d11-8a4e-6c3f0b9d2e81", "errors": ["distinct_id: Too small: expected string to have >=1 characters"] }
  ],
  "filtered": 0
}

# pip install requests
import time
import uuid
from datetime import datetime, timezone

import requests

HOST = "https://api.anyanalytics.org"
WRITE_KEY = "vxw_YOUR_WRITE_KEY"


def now():
    return datetime.now(timezone.utc).isoformat()


def event(name, distinct_id, properties=None):
    # The uuid is created once, with the event, and reused on every retry
    return {
        "uuid": str(uuid.uuid4()),
        "event": name,
        "distinct_id": distinct_id,
        "timestamp": now(),
        "properties": properties or {},
    }


def send(events, attempts=6):
    for attempt in range(attempts):
        res = None
        try:
            res = requests.post(
                HOST + "/v1/batch",
                json={"sent_at": now(), "batch": events},
                headers={"Authorization": "Bearer " + WRITE_KEY},
                timeout=10,
            )
        except requests.RequestException:
            pass  # network error: retry below

        if res is not None and res.ok:
            for r in res.json()["rejected"]:
                print("rejected", events[r["index"]]["event"], r["errors"])
            return
        if res is not None and res.status_code not in (408, 429) and res.status_code < 500:
            # Bad key or bad payload: retrying won't help
            raise RuntimeError(f"HTTP {res.status_code}: {res.text}")

        retry_after = res.headers.get("Retry-After") if res is not None else None
        time.sleep(float(retry_after) if retry_after else 2**attempt)
    raise RuntimeError("gave up; keep the events and try again later")


send([event("order_completed", "user_123", {"order_id": "ord_123", "total": 49.9})])

// .NET 6 or newer
using System;
using System.Net.Http;
using System.Net.Http.Json;

var http = new HttpClient { Timeout = TimeSpan.FromSeconds(10) };
http.DefaultRequestHeaders.Add("Authorization", "Bearer vxw_YOUR_WRITE_KEY");

var batch = new[]
{
    new
    {
        uuid = Guid.NewGuid().ToString(), // keep it if you resend this event
        @event = "order_completed",
        distinct_id = "user_123",
        timestamp = DateTime.UtcNow.ToString("o"),
        properties = new { order_id = "ord_123", total = 49.9 },
    },
};

var response = await http.PostAsJsonAsync("https://api.anyanalytics.org/v1/batch", new
{
    sent_at = DateTime.UtcNow.ToString("o"),
    batch,
});

var status = (int)response.StatusCode;
if (status == 408 || status == 429 || status >= 500)
{
    // Send the same batch again later, after Retry-After when it's given
    var wait = response.Headers.RetryAfter?.Delta ?? TimeSpan.FromSeconds(5);
}
else if (!response.IsSuccessStatusCode)
{
    // Bad key or bad payload: don't retry
    Console.Error.WriteLine(await response.Content.ReadAsStringAsync());
}