---
title: "List keywords"
method: GET
path: "/keywords/values"
tags: ["Keywords"]
---

# List keywords

`GET /keywords/values`

## Request

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

Returns the keywords the authenticated account's audiences can target, so a client can discover the names an Audience Filter accepts without hardcoding them. Results are cursor-paginated: `next_cursor` is null on the last page.

## Query parameters

- `cursor` string: Opaque token from a previous response's next_cursor, to fetch the next page. Omit for the first page.
- `limit` integer: Maximum keywords to return in the page; defaults to 100.
- `search_text` string: Case-insensitive substring filter on the keyword.

## Response `200`

OK

- ListKeywordsOutput
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `items` Keyword[], nullable, required: The keywords of the page.
    - `created_at` integer, required: When the keyword was created, in milliseconds since the Unix epoch.
    - `opted_out_contact_count` integer, nullable, required: Contacts who opted out after using this keyword.
    - `phone_number` string, required: The number the keyword is registered on.
    - `status` 'active' | 'expired' | 'paused', required: The status of the keyword.
    - `subscribed_contact_count` integer, nullable, required: Contacts subscribed through this keyword.
    - `value` string, required: The keyword; use it in an Audience Filter.
  - `next_cursor` string, nullable, required: Cursor for the next page; null on the last page.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `412`: Precondition Failed
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `500`: Internal Server Error
- `501`: Not Implemented
- `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)