List Groups | Reloop Docs

GET

https://reloop.sh/api/contacts/v1/groups/list

Query Parameters

pagenumberdefault: 1

Minimum value: 1

limitnumberdefault: 100

Minimum value: 1
Maximum value: 100

searchstring

Search by name

import { Reloop } from "reloop-email";

const reloop = new Reloop({ apiKey: "rl_123456789" });

const { response: groups, error } = await reloop.contacts.listGroups({ page: 1, limit: 10 });
if (error) throw error;

{
  "object": "contact_group",
  "groups": [
    {
      "object": "contact_group",
      "id": "grp_123456789",
      "name": "Beta Testers",
      "createdAt": "2026-03-27T10:00:00Z",
      "updatedAt": "2026-03-27T10:00:00Z"
    }
  ],
  "total": 1,
  "page": 0,
  "limit": 0,
  "event": "evt_123456789"
}