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

# List Predefined Texts

> Retrieve all custom text prompts configured for your organisation, used to guide users during enrollment and verification.

## Overview

Predefined texts are the voice prompts or on-screen instructions you configure to guide users through enrollment and verification. Because Voxmind is text-independent, users can say anything — but in a well-designed authentication UX, you'll want to present them with a specific prompt that feels natural and consistent with your application.

For example, a contact centre might configure: *"Please say your name and account reference to verify your identity."* A banking app might use: *"Please say your passphrase to confirm this transaction."* Each text is associated with a language code and a `text_code` integer that you define to categorise it (e.g. `1` = enrollment prompt, `2` = verification prompt).

<Note>
  Predefined texts are entirely optional configuration. If you don't configure any, Voxmind still processes voice data correctly — you'd simply handle the user-facing prompt within your own application UI.
</Note>

## Path Parameters

<ParamField path="orgId" type="string" required>
  Your organisation's unique identifier.
</ParamField>

## Query Parameters

<ParamField query="filter" type="string">
  Filter texts. Example: `filter=language=en-UK` for all English texts, or `filter=text_code=1` for all enrollment prompts.
</ParamField>

<ParamField query="sort" type="string">
  Sort order. Example: `sort=language:asc`
</ParamField>

<ParamField query="per_page" type="integer" default="100">
  Results per page. Maximum 300.
</ParamField>

<ParamField query="page" type="integer" default="1">
  Page number.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  # Get all English texts
  curl -X GET "https://api.voxmind.ai/organisations/42/predefined-texts?filter=language=en-UK" \
    -H "Authorization: Bearer YOUR_API_TOKEN" \
    -H "Accept: application/json"
  ```

  ```python Python theme={null}
  resp = requests.get(
      "https://api.voxmind.ai/organisations/42/predefined-texts",
      headers={"Authorization": "Bearer YOUR_API_TOKEN"},
      params={"filter": "language=en-UK"},
  )
  texts = resp.json()["results"]
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "results": [
      {
        "id": 21,
        "org_id": 42,
        "language": "en-UK",
        "text_code": 1,
        "text": "Please say your full name to register your voice.",
        "created_at": "2025-02-01T09:00:00Z",
        "updated_at": "2025-02-01T09:00:00Z"
      },
      {
        "id": 22,
        "org_id": 42,
        "language": "en-UK",
        "text_code": 2,
        "text": "Please say your name and account number to verify your identity.",
        "created_at": "2025-02-01T09:00:00Z",
        "updated_at": "2025-02-01T09:00:00Z"
      }
    ]
  }
  ```
</ResponseExample>