> ## Documentation Index
> Fetch the complete documentation index at: https://docs.msgflash.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET List groups

> List your account contact groups with cursor pagination and optional search.

## Endpoint

```txt theme={null}
GET /api/v1/contacts/groups
```

## Query parameters

| Field    | Type    | Required | Description                                                     |
| -------- | ------- | -------- | --------------------------------------------------------------- |
| `limit`  | integer | no       | Page size, default `50`, max `100`                              |
| `cursor` | string  | no       | Opaque cursor returned by the previous page                     |
| `search` | string  | no       | Case-insensitive match on `name` or `description` (1-100 chars) |

## Success response `200`

```json theme={null}
{
  "data": {
    "groups": [
      {
        "id": "grp_uuid",
        "name": "VIPs",
        "description": "High-priority contacts",
        "color": "#facc15",
        "contactCount": 42,
        "createdAt": "2026-04-01T10:00:00.000Z"
      }
    ],
    "total": 7,
    "limit": 50,
    "nextCursor": null,
    "hasMore": false
  }
}
```

## Notes

* Pass the `nextCursor` value back as `cursor` to fetch the next page. Stop when `hasMore` is `false` or `nextCursor` is `null`.