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

# List of placeholders

> List all placeholders of a contract or template, with their values and who fills them in, via the Sendforsign API.

### Body parameters

**data** `object` *required*

**child attribute**

**action** `string` *required*

Action type.

**clientKey** `string` *required*

Key of the client.

**templateKey** `string`

ID of the template. Use this parameter if you need to retrieve a template's placeholders.

**contractKey** `string`

Key of the contract. Use this parameter if you need to retrieve a contract's placeholders.

### Response

**placeholders** `string`

Array of placeholders.

**child attribute**

**id** `string`

ID of the placeholder.

**createTime** `string`

Create time.

**changeTime** `string`

Change time.

**name** `string`

Name of the placeholder.

**value** `string`

Value of the placeholder.

**placeholderKey** `string`

Key of the placeholder.

**position** `string`

Position of the placeholder.

**fillingType** `string`

Who fills in the placeholder: `1` — nobody, `2` — the contract owner, `3` — any recipient, `4` — a specific recipient (see `externalRecipientKey`).

**externalRecipientKey** `string`

`recipientKey` of the recipient who fills in the placeholder, or `null`.

**code** `string`

The code of the answer.

**message** `string`

The message of the answer.

```bash cURL theme={null}
curl -X POST 'https://api.sendforsign.com/api/placeholder' \ 
     -H 'X-Sendforsign-Key: YOUR_API_KEY' \
     -H 'Content-Type: application/json' \
     -d '{ 
          "data": {
              "action": "list",
              "clientKey": "YOUR_CLIENT_KEY",
              "contractKey": "CONTRACT_KEY",
              "templateKey": "TEMPLATE_KEY"
				  }
     }'
```

```json Response theme={null}
{
    "placeholders": [
        {
            "id": "1",
            "createTime": "2024-02-26T11:07:55.000Z",
            "changeTime": "2024-02-26T11:07:59.000Z",
            "name": "Placeholder Name",
            "value": "Placeholder Value",
            "placeholderKey": "PLACEHOLDER_KEY",
            "position": 1,
            "fillingType": "4",
            "externalRecipientKey": "RECIPIENT_KEY"
        }
    ],
    "code": "200",
    "message": "Placeholders found"
}
```


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