# Say

## Say Attributes

| Name         | Description                                                               | Allowed Values       | Default Value |
| ------------ | ------------------------------------------------------------------------- | -------------------- | ------------- |
| **language** | Voice and Language                                                        | listed at the bottom | kevin         |
| **loop**     | How many times to play the synthesized text. Zero will loop indefinitely. | non-negative integer | 1             |

## Nesting

{% hint style="info" %}
&#x20;The **\<Say>** verb cannot have any other verbs or nouns nested. Only text can be part of the  \<say> verb.
{% endhint %}

## Examples

{% hint style="info" %}
Below is an example of using the \<say> verb.
{% endhint %}

```markup
<Response>
    <Say>Hello World</Say>
</Response>
```

{% hint style="info" %}
Choose your voice and language based on the list at the bottom of this page
{% endhint %}

```markup
<Response>
    <Say language="joanna-en-US-female">Hello World</Say>
</Response>
```

## Voices

To use a specific provider specify it in the language attribute, as shown below. Voices are all from AWS Polly.

```markup
Danish (da-DK)
language="naja-da-DK-female"  - Naja
language="mads-da-DK-male"  - Mads


Dutch (nl-NL)
language="lotte-nl-NL-female"  - Lotte
language="ruben-nl-NL-male"  - Ruben


English (Australian) (en-AU)
language="nicole-en-au-female"  - Nicole
language="olivia-en-au-female"  - Olivia
language="russell-en-au-male"  - Russell


English (British) (en-GB)
language="amy-en-GB-female"  - Amy
language="emma-en-GB-female"  - Emma
language="brian-en-GB-male"  - Brian


English (Indian) (en-IN)
language="aditi-en-IN-female"  - Aditi
language="raveena-en-IN-female"  - Raveena


English (US) (en-US)
language="ivy-en-US-female"  - Ivy
language="joanna-en-US-female"  - Joanna
language="kendra-en-US-female"  - Kendra
language="kimberly-en-US-female"  - Kimberly
language="salli-en-US-female"  - Salli
language="joey-en-US-male"  - Joey
language="justin-en-US-male"  - Justin
language="kevin-en-US-male"  - Kevin
language="matthew-en-US-male"  - Matthew


English (Welsh) (en-GB-WLS)
language="geraint-en-GB-WLS-male"  - Geraint


French (fr-FR)
language="celine-fr-FR-female"  - Celine
language="lea-fr-FR-female"  - Lea
language="mathieu-fr-FR-male"  - Mathieu


French (Canadian) (fr-CA)
language="chantal-fr-CA-female"  - Chantal


German (de-DE)
language="marlene-de-DE-female"  - Marlene
language="vicki-de-DE-female"  - Vicki
language="hans-de-DE-male"  - Hans


Icelandic (is-IS)
language="dora-is-IS-female"  - Dóra/Dora
language="karl-is-IS-male"  - Karl


Italian (it-IT)
language="carla-it-IT-female"  - Carla
language="bianca-it-IT-female"  - Bianca
language="giorgio-it-IT-male"  - Giorgio


Japanese (ja-JP)
language="mizuki-ja-PA-female"  - Mizuki
language="takumi-ja-PA-male"  - Takumi


Norwegian (nb-NO)
language="liv-nb-NO-female"  - Liv


Polish (pl-PL)
language="ewa-pl-PL-female"  - Ewa
language="maja-pl-PL-female"  - Maja
language="jacek-pl-PL-male"  - Jacek
language="jan-pl-PL-male"  - Jan


Portuguese (Brazilian) (pt-BR)
language="camila-bp-BR-female"  - Camila
language="vitoria-bp-BR-female"  - Vitoria
language="ricardo-bp-BR-male"  - Ricardo


Portuguese (European) (pt-PT)
language="ines-pt-PT-female"  - Ines
language="cristiano-pt-PT-male"  - Cristiano


Romanian (ro-RO)
language="carmen-ro-RO-female"  - Carmen


Russian (ru-RU)
language="tatyana-ru-RU-female"  - Tatyana
language="maxim-ru-RU-male"  - Maxim


Spanish (European) (es-ES)
language="conchita-es-ES-female"  - Conchita
language="lucia-es-ES-female"  - Lucia
language="enrique-es-ES-male"  - Enrique


Spanish (Mexican) (es-MX)
language="mia-es-MX-female"  - Mia


US Spanish (es-US)
language="lupe-es-US-female"  - Lupe
language="penelope-es-US-female"  - Penelope
language="miguel-es-US-male"  - Miguel


Swedish (sv-SE)
language="astrid-sv-SE-female"  - Astrid


Turkish (tr-TR)
language="filiz-tr-TR-female"  - Filiz


Welsh (cy-GB)
language="gwyneth-cy-GB-female"  - Gwyneth
```

JSON of all supported languages:

```
{
    "Danish (da-DK)": [
        {
            "language_use": "naja-da-DK-female",
            "name": "Naja"
        },
        {
            "language_use": "mads-da-DK-male",
            "name": "Mads"
        }
    ],
    "Dutch (nl-NL)": [
        {
            "language_use": "lotte-nl-NL-female",
            "name": "Lotte"
        },
        {
            "language_use": "ruben-nl-NL-male",
            "name": "Ruben"
        }
    ],
    "English (Australian) (en-AU)": [
        {
            "language_use": "nicole-en-au-female",
            "name": "Nicole"
        },
        {
            "language_use": "olivia-en-au-female",
            "name": "Olivia"
        },
        {
            "language_use": "russell-en-au-male",
            "name": "Russell"
        }
    ],
    "English (British) (en-GB)": [
        {
            "language_use": "amy-en-GB-female",
            "name": "Amy"
        },
        {
            "language_use": "emma-en-GB-female",
            "name": "Emma"
        },
        {
            "language_use": "brian-en-GB-male",
            "name": "Brian"
        }
    ],
    "English (Indian) (en-IN)": [
        {
            "language_use": "aditi-en-IN-female",
            "name": "Aditi"
        },
        {
            "language_use": "raveena-en-IN-female",
            "name": "Raveena"
        }
    ],
    "English (US) (en-US)": [
        {
            "language_use": "ivy-en-US-female",
            "name": "Ivy"
        },
        {
            "language_use": "joanna-en-US-female",
            "name": "Joanna"
        },
        {
            "language_use": "kendra-en-US-female",
            "name": "Kendra"
        },
        {
            "language_use": "kimberly-en-US-female",
            "name": "Kimberly"
        },
        {
            "language_use": "salli-en-US-female",
            "name": "Salli"
        },
        {
            "language_use": "joey-en-US-male",
            "name": "Joey"
        },
        {
            "language_use": "justin-en-US-male",
            "name": "Justin"
        },
        {
            "language_use": "kevin-en-US-male",
            "name": "Kevin"
        },
        {
            "language_use": "matthew-en-US-male",
            "name": "Matthew"
        }
    ],
    "English (Welsh) (en-GB-WLS)": [
        {
            "language_use": "geraint-en-GB-WLS-male",
            "name": "Geraint"
        }
    ],
    "French (fr-FR)": [
        {
            "language_use": "celine-fr-FR-female",
            "name": "Celine"
        },
        {
            "language_use": "lea-fr-FR-female",
            "name": "Lea"
        },
        {
            "language_use": "mathieu-fr-FR-male",
            "name": "Mathieu"
        }
    ],
    "French (Canadian) (fr-CA)": [
        {
            "language_use": "chantal-fr-CA-female",
            "name": "Chantal"
        }
    ],
    "German (de-DE)": [
        {
            "language_use": "marlene-de-DE-female",
            "name": "Marlene"
        },
        {
            "language_use": "vicki-de-DE-female",
            "name": "Vicki"
        },
        {
            "language_use": "hans-de-DE-male",
            "name": "Hans"
        }
    ],
    "Icelandic (is-IS)": [
        {
            "language_use": "dora-is-IS-female",
            "name": "Dora"
        },
        {
            "language_use": "karl-is-IS-male",
            "name": "Karl"
        }
    ],
    "Italian (it-IT)": [
        {
            "language_use": "carla-it-IT-female",
            "name": "Carla"
        },
        {
            "language_use": "bianca-it-IT-female",
            "name": "Bianca"
        },
        {
            "language_use": "giorgio-it-IT-male",
            "name": "Giorgio"
        }
    ],
    "Japanese (ja-JP)": [
        {
            "language_use": "mizuki-ja-PA-female",
            "name": "Mizuki"
        },
        {
            "language_use": "takumi-ja-PA-male",
            "name": "Takumi"
        }
    ],
    "Norwegian (nb-NO)": [
        {
            "language_use": "liv-nb-NO-female",
            "name": "Liv"
        }
    ],
    "Polish (pl-PL)": [
        {
            "language_use": "ewa-pl-PL-female",
            "name": "Ewa"
        },
        {
            "language_use": "maja-pl-PL-female",
            "name": "Maja"
        },
        {
            "language_use": "jacek-pl-PL-male",
            "name": "Jacek"
        },
        {
            "language_use": "jan-pl-PL-male",
            "name": "Jan"
        }
    ],
    "Portuguese (Brazilian) (pt-BR)": [
        {
            "language_use": "camila-bp-BR-female",
            "name": "Camila"
        },
        {
            "language_use": "vitoria-bp-BR-female",
            "name": "Vitoria"
        },
        {
            "language_use": "ricardo-bp-BR-male",
            "name": "Ricardo"
        }
    ],
    "Portuguese (European) (pt-PT)": [
        {
            "language_use": "ines-pt-PT-female",
            "name": "Ines"
        },
        {
            "language_use": "cristiano-pt-PT-male",
            "name": "Cristiano"
        }
    ],
    "Romanian (ro-RO)": [
        {
            "language_use": "carmen-ro-RO-female",
            "name": "Carmen"
        }
    ],
    "Russian (ru-RU)": [
        {
            "language_use": "tatyana-ru-RU-female",
            "name": "Tatyana"
        },
        {
            "language_use": "maxim-ru-RU-male",
            "name": "Maxim"
        }
    ],
    "Spanish (European) (es-ES)": [
        {
            "language_use": "conchita-es-ES-female",
            "name": "Conchita"
        },
        {
            "language_use": "lucia-es-ES-female",
            "name": "Lucia"
        },
        {
            "language_use": "enrique-es-ES-male",
            "name": "Enrique"
        }
    ],
    "Spanish (Mexican) (es-MX)": [
        {
            "language_use": "mia-es-MX-female",
            "name": "Mia"
        }
    ],
    "US Spanish (es-US)": [
        {
            "language_use": "lupe-es-US-female",
            "name": "Lupe"
        },
        {
            "language_use": "penelope-es-US-female",
            "name": "Penelope"
        },
        {
            "language_use": "miguel-es-US-male",
            "name": "Miguel"
        }
    ],
    "Swedish (sv-SE)": [
        {
            "language_use": "astrid-sv-SE-female",
            "name": "Astrid"
        }
    ],
    "Turkish (tr-TR)": [
        {
            "language_use": "filiz-tr-TR-female",
            "name": "Filiz"
        }
    ],
    "Welsh (cy-GB)": [
        {
            "language_use": "gwyneth-cy-GB-female",
            "name": "Gwyneth"
        }
    ]
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://apidocs.api19.com/call-api-markup/api-call-markup-language/say.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.