---
title: "List group values"
method: GET
path: "/groups/values"
tags: ["Groups"]
---

# List group values

`GET /groups/values`

## Request

- Base URL: `https://api.textla.com/v1`
- URL: `https://api.textla.com/v1/groups/values`
- Auth: HTTP bearer

Returns the cursor-paginated group values for the authenticated account. Values are account-level reference data and may be listed even when no contact currently carries them. The default page size is 100 and default order is alphabetical; reset cursor when changing order_by or search_text.

## Query parameters

- `cursor` string: Opaque token for the next page
- `include_counts` boolean: Include the number of contacts carrying each value
- `limit` integer: Maximum number of values to return; defaults to 100
- `order_by` 'alphabetical' | 'created_at': Row order: alphabetical ascending or created_at newest-first; reset cursor when changing order
- `search_text` string: Case-insensitive substring filter

## Response `200`

OK

- PageEnvelopeAttributeValueItem
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `items` AttributeValueItem[], nullable, required
    - `$schema` string, uri: A URL to the JSON Schema for this object.
    - `contact_count` integer
    - `created_at` integer, required: When this reference-data value was first created, as milliseconds since the Unix epoch
    - `description` string, nullable, required
    - `value` string, required
  - `next_cursor` string, nullable, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `412`: Precondition Failed
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `500`: Internal Server Error
- `502`: Bad Gateway
- `503`: Service Unavailable
- `504`: Gateway Timeout

---

[API](https://skmtc.dev/textla/apis/textla-api.md) - [All operations](https://skmtc.dev/textla/apis/textla-api/llms.txt) - [OpenAPI document](https://skmtc.dev/textla/apis/textla-api/revisions/473f03350bc1?raw)