API ReferenceUsage

Get usage

Traffic and requests over time, split by network, sub-user or day.

GEThttps://api.riftip.com/v1/usage

#Query parameters

Parameter	Type	Description
`from`	date, required	Start date, `YYYY-MM-DD` (UTC, inclusive).
`to`	date, required	End date, inclusive. Up to 92 days after `from`.
`group_by`	string	`day` (default), `network` or `sub_user`.
`network`	string	Only count one network.
`sub_user`	string	Only count one sub-user, by ID.

#Request

curl "https://api.riftip.com/v1/usage?from=2026-10-01&to=2026-10-03&group_by=day" \
  -H "Authorization: Bearer $RIFTIP_API_KEY"

const params = new URLSearchParams({ from: "2026-10-01", to: "2026-10-03", group_by: "day" });
const res = await fetch(`https://api.riftip.com/v1/usage?${params}`, {
  headers: { Authorization: `Bearer ${process.env.RIFTIP_API_KEY}` },
});
const usage = await res.json();

usage = requests.get(
    "https://api.riftip.com/v1/usage",
    params={"from": "2026-10-01", "to": "2026-10-03", "group_by": "day"},
    headers={"Authorization": f"Bearer {API_KEY}"},
).json()

#Response

JSON

{
  "from": "2026-10-01",
  "to": "2026-10-03",
  "group_by": "day",
  "totals": { "bytes": 46170898432, "requests": 1284310 },
  "data": [
    { "key": "2026-10-01", "bytes": 15569256448, "requests": 431902 },
    { "key": "2026-10-02", "bytes": 14495514624, "requests": 402211 },
    { "key": "2026-10-03", "bytes": 16106127360, "requests": 450197 }
  ]
}

Note

Usage is final about five minutes after traffic happens. Figures for the last few minutes may still rise slightly.