API ReferenceSub-users

List sub-users

Every sub-user on your account, newest first.

GEThttps://api.riftip.com/v1/sub-users

#Query parameters

Parameter	Type	Description
`limit`	integer	Results per page, 1–100. Default `25`.
`starting_after`	string	Cursor from the previous page's `next_cursor`.
`status`	string	Filter by `active` or `disabled`.

#Request

curl "https://api.riftip.com/v1/sub-users?limit=2" \
  -H "Authorization: Bearer $RIFTIP_API_KEY"

const res = await fetch("https://api.riftip.com/v1/sub-users?limit=2", {
  headers: { Authorization: `Bearer ${process.env.RIFTIP_API_KEY}` },
});
const { data, has_more, next_cursor } = await res.json();

page = requests.get(
    "https://api.riftip.com/v1/sub-users",
    params={"limit": 2},
    headers={"Authorization": f"Bearer {API_KEY}"},
).json()

#Response

JSON

{
  "data": [
    {
      "id": "su_8f2k1d",
      "username": "acme-scraper",
      "status": "active",
      "traffic_limit_bytes": 107374182400,
      "traffic_used_bytes": 5368709120,
      "created_at": "2026-10-02T11:20:00Z"
    },
    {
      "id": "su_3b7q9x",
      "username": "acme-monitor",
      "status": "active",
      "traffic_limit_bytes": null,
      "traffic_used_bytes": 912680550,
      "created_at": "2026-09-18T08:04:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "su_3b7q9x"
}