Customer attribution

curl https://api.aireserve.com/v1/chat/completions \
  -H "Authorization: Bearer $AIRESERVE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "x-aireserve-customer: cust_8f3a2b" \
  -H "x-aireserve-feature: draft-email" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "Draft a follow-up to the Acme call."}]
  }'

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.aireserve.com/v1",
    api_key=os.environ["AIRESERVE_API_KEY"],
)

# Option A — the OpenAI `user` field; no header needed.
res = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "Draft a follow-up to the Acme call."}],
    user="cust_8f3a2b",
)

# Option B — headers; add the optional feature tag too.
res = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "Draft a follow-up to the Acme call."}],
    extra_headers={
        "x-aireserve-customer": "cust_8f3a2b",
        "x-aireserve-feature": "draft-email",
    },
)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.aireserve.com/v1",
  apiKey: process.env.AIRESERVE_API_KEY,
});

// Option A — the OpenAI `user` field; no header needed.
await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "Draft a follow-up to the Acme call." }],
  user: "cust_8f3a2b",
});

// Option B — headers; add the optional feature tag too.
await client.chat.completions.create(
  {
    model: "gpt-5.5",
    messages: [{ role: "user", content: "Draft a follow-up to the Acme call." }],
  },
  {
    headers: {
      "x-aireserve-customer": "cust_8f3a2b",
      "x-aireserve-feature": "draft-email",
    },
  },
);

# A key for the customer
curl -X POST "https://api.aireserve.com/v1/customers/cust_8f3a2b/keys" \
  -H "Authorization: Bearer $AIRESERVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Acme production"}'

# A sub key for one of the customer's organizations
curl -X POST "https://api.aireserve.com/v1/customers/cust_8f3a2b/keys" \
  -H "Authorization: Bearer $AIRESERVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"org_id": "emea"}'

import os, requests
from urllib.parse import quote

headers = {"Authorization": f"Bearer {os.environ['AIRESERVE_API_KEY']}"}
customer_id = "cust_8f3a2b"

created = requests.post(
    f"https://api.aireserve.com/v1/customers/{quote(customer_id, safe='')}/keys",
    json={"org_id": "emea"},
    headers=headers,
).json()
secret = created["key"]  # shown once — hand it to the customer and store it

const customerId = "cust_8f3a2b";
const created = await fetch(
  `https://api.aireserve.com/v1/customers/${encodeURIComponent(customerId)}/keys`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.AIRESERVE_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ org_id: "emea" }),
  },
).then((r) => r.json());
const secret = created.key; // shown once — hand it to the customer and store it

# Every customer, last 30 days
curl "https://api.aireserve.com/v1/customers/usage" \
  -H "Authorization: Bearer $AIRESERVE_API_KEY"

# One customer, September, by feature
curl "https://api.aireserve.com/v1/customers/cust_8f3a2b/usage?start=2026-09-01&end=2026-10-01" \
  -H "Authorization: Bearer $AIRESERVE_API_KEY"

import os, requests
from urllib.parse import quote

headers = {"Authorization": f"Bearer {os.environ['AIRESERVE_API_KEY']}"}

# Every customer, last 30 days
report = requests.get("https://api.aireserve.com/v1/customers/usage", headers=headers).json()
for row in report["customers"]:
    print(row["customer_id"], "cost", row["cost_usd"], "owes", row.get("billable_usd"))

# One customer, September, by feature
customer_id = "cust_8f3a2b"
statement = requests.get(
    f"https://api.aireserve.com/v1/customers/{quote(customer_id, safe='')}/usage",
    params={"start": "2026-09-01", "end": "2026-10-01", "group_by": "feature"},
    headers=headers,
).json()
print(statement["totals"]["billable_usd"])

const headers = { Authorization: `Bearer ${process.env.AIRESERVE_API_KEY}` };

// Every customer, last 30 days
const report = await fetch("https://api.aireserve.com/v1/customers/usage", { headers }).then((r) => r.json());
for (const row of report.customers) {
  console.log(row.customer_id, "cost", row.cost_usd, "owes", row.billable_usd);
}

// One customer, September, by feature
const customerId = "cust_8f3a2b";
const params = new URLSearchParams({ start: "2026-09-01", end: "2026-10-01", group_by: "feature" });
const statement = await fetch(
  `https://api.aireserve.com/v1/customers/${encodeURIComponent(customerId)}/usage?${params}`,
  { headers },
).then((r) => r.json());
console.log(statement.totals.billable_usd);