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

# List all groups

Returns a list of all groups configured for your organisation.

Groups are returned in descending order of creation time, with the most recently created groups appearing first. Each group object includes contact details, branding information, and business identifiers used to theme envelopes and route shared access.

This endpoint supports basic exact-match filtering on key attributes. The response is limited to a maximum of 1,000 results.

## Parameters

<ParamField path="name" type="optional">
  Filter by exact match on the group's `name` property.
</ParamField>

<ParamField path="business" type="optional">
  Filter by exact match on the group's `business` property.
</ParamField>

<ParamField path="email" type="optional">
  Filter by exact match on the group's `email` property.
</ParamField>

<RequestExample>
  ```bash Endpoint theme={null}
  GET /v1/groups
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  [{
    "id": "a5a885caee6286a54ad7bbd4ab5400e9",
    "name": "Annature group",
    "business": "Annature",
    "email": "ted@annature.com.au",
    "number": "1300 000 000",
    "address": "Level 38, 71 Eagle Street, Brisbane 4000",
    "website": "www.annature.com.au",
    "logo": "https://annature..",
    "colour": "#5469d4",
    "created": "2019-12-17T05:30:00Z"
  }]
  ```
</ResponseExample>