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

# Get Truecaller Template Variables

> List the placeholders a caller must send for a Truecaller template

#### Description

Lists the placeholders the caller must send in `variables` for a [template send](https://docs.zixflow.com/api-reference/zixflow-ai/truecaller/send-template.md). Placeholders that start with `brand.` are filled by Zixflow and are left out. Keys are returned in order of first use: message text, then media URL, then link URLs. Each `type` is `text`.

`data` is an array. A template with no caller variables returns `"data": []`.

#### Headers

**x-api-key** `string` *required*

Your API key for authentication. The workspace on the key must match `x-workspace-id`.

**x-workspace-id** `string` *required*

Workspace id that owns the API key.

#### Path Parameters

**bot\_id** `string` *required*

Bot (channel settings) id. A value that is not a 24-character hex id returns `404`.

#### Query Parameters

**template\_name** `string` *required*

Template name, for example `order_shipped`.

#### Request Example

```http theme={null}
GET /api/data/truecaller/v1/665f1c2a8e4b9a0012ab34cd/variable-keys?template_name=order_shipped
```

#### Response

**success** `boolean`

`true` when the template was found.

**message** `string`

`Request processed successfully` on success.

**data** `array`

Caller variables, in order of first use. Empty when the template has no caller variables.

**data\[].key** `string`

Placeholder name. Letters, digits, `_`, and `.`. Send this as a key in `variables`.

**data\[].type** `string`

Always `text`.

```json 200-Success theme={null}
{
  "success": true,
  "message": "Request processed successfully",
  "data": [
    { "key": "name", "type": "text" },
    { "key": "order_id", "type": "text" }
  ]
}
```

```json 200-No Variables theme={null}
{
  "success": true,
  "message": "Request processed successfully",
  "data": []
}
```

```json 400-Bad Request theme={null}
{
  "success": false,
  "message": "template_name is required"
}
```

```json 401-Unauthorized theme={null}
{
  "error": true,
  "message": "Unauthorized"
}
```

```json 404-Not Found theme={null}
{
  "success": false,
  "message": "Truecaller template not found for this bot"
}
```

```json 500-Internal Server Error theme={null}
{
  "success": false,
  "message": "Failed to get Truecaller template variables"
}
```

`400` messages are `bot_id is required` or `template_name is required`.

`404` is returned for an unknown name, the wrong workspace, or a `bot_id` that is not a 24-character hex id.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.