> ## Documentation Index
> Fetch the complete documentation index at: https://signatureapi-daf4ee54.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Date Places

> Automatically insert completion dates for individual recipients or the entire envelope

Date places insert completion timestamps automatically at a specific location in a document. There are two types: one that records when a [specific recipient](#recipient-completed-date) completed their action, and one that records when [the entire envelope](#envelope-completed-date) was completed.

You can position date places using either [placeholders](/docs/api/resources/places/positioning/#placeholders) or [fixed positions](/docs/api/resources/places/positioning/#fixed-positions).

## Date Format

Both date place types accept a `date_format` property that controls how the date is rendered. Use [Moment.js format syntax](https://momentjs.com/docs/#/displaying/format/).

The default format is `D MMM YYYY`, which renders as *31 Dec 2025*.

Common formats:

| Format string      | Example output    |
| ------------------ | ----------------- |
| `D MMM YYYY`       | 31 Dec 2025       |
| `YYYY-MM-DD`       | 2025-12-31        |
| `MM/DD/YYYY`       | 12/31/2025        |
| `MMMM D, YYYY`     | December 31, 2025 |
| `DD/MM/YYYY HH:mm` | 31/12/2025 14:30  |

***

## Recipient Completed Date

A **recipient completed date** place records the date and time when the specific recipient identified by `recipient_key` completed their action on the envelope.

### Example

```json theme={null}
"documents": [
  {
    //...
    "places": [
      {
        "key": "employer_signed_at",
        "type": "recipient_completed_date",
        "recipient_key": "employer",
        "date_format": "YYYY-MM-DD"
      }
    ]
    //...
  }
]
```

### Attributes

<ParamField body="type" type="enum" required={true}>
  Specifies the type of place.

  For this kind of place, the value must be `recipient_completed_date`.
</ParamField>

<ParamField body="key" type="string" required={true}>
  A unique identifier for this place within the document. Use this key to match the place to its position, either through a `[[place_key]]` placeholder in the document or an entry in `fixed_positions`.

  Must start with a lowercase letter and contain only lowercase letters, numbers, and underscores. Maximum 32 characters.
</ParamField>

<ParamField body="recipient_key" type="string" required={true}>
  The key of the recipient assigned to this place. Must match one of the `key` values in the envelope's `recipients` array.
</ParamField>

<ParamField body="date_format" type="string">
  The date and time format using [Moment.js syntax](https://momentjs.com/docs/#/displaying/format/). Common formats include `D MMM YYYY` (31 Dec 2025), `YYYY-MM-DD` (2025-12-31), and `MM/DD/YYYY` (12/31/2025).

  Defaults to `D MMM YYYY`.
</ParamField>

<ParamField body="font_size" type="number">
  The font size in <Tooltip tip="1/72 of an inch">points</Tooltip>. Must be between 1 and 144. Defaults to 12.
</ParamField>

***

## Envelope Completed Date

An **envelope completed date** place records the date and time when the entire envelope was completed, meaning all recipients have finished their actions.

This place type does not require a `recipient_key` because it applies to the envelope as a whole.

### Example

```json theme={null}
"documents": [
  {
    //...
    "places": [
      {
        "key": "signed_by_all_at",
        "type": "envelope_completed_date",
        "date_format": "MM/DD/YYYY HH:mm"
      }
    ]
    //...
  }
]
```

### Attributes

<ParamField body="type" type="enum" required={true}>
  Specifies the type of place.

  For this kind of place, the value must be `envelope_completed_date`.
</ParamField>

<ParamField body="key" type="string" required={true}>
  A unique identifier for this place within the document. Use this key to match the place to its position, either through a `[[place_key]]` placeholder in the document or an entry in `fixed_positions`.

  Must start with a lowercase letter and contain only lowercase letters, numbers, and underscores. Maximum 32 characters.
</ParamField>

<ParamField body="date_format" type="string">
  The date and time format using [Moment.js syntax](https://momentjs.com/docs/#/displaying/format/). Common formats include `D MMM YYYY` (31 Dec 2025), `YYYY-MM-DD` (2025-12-31), and `MM/DD/YYYY` (12/31/2025).

  Defaults to `D MMM YYYY`.
</ParamField>

<ParamField body="font_size" type="number">
  The font size in <Tooltip tip="1/72 of an inch">points</Tooltip>. Must be between 1 and 144. Defaults to 12.
</ParamField>

***

## More Examples

<CodeGroup>
  ```json ISO Format (YYYY-MM-DD) theme={null}
  "documents": [
    {
      //...
      "places": [
        {
          "key": "signed_date",
          "type": "recipient_completed_date",
          "recipient_key": "signer",
          "date_format": "YYYY-MM-DD"
        }
      ]
      //...
    }
  ]
  ```

  ```json US Format (MM/DD/YYYY) theme={null}
  "documents": [
    {
      //...
      "places": [
        {
          "key": "completion_date",
          "type": "recipient_completed_date",
          "recipient_key": "client",
          "date_format": "MM/DD/YYYY"
        }
      ]
      //...
    }
  ]
  ```

  ```json With Time (DD/MM/YYYY HH:mm) theme={null}
  "documents": [
    {
      //...
      "places": [
        {
          "key": "timestamp",
          "type": "envelope_completed_date",
          "date_format": "DD/MM/YYYY HH:mm"
        }
      ]
      //...
    }
  ]
  ```

  ```json Long Format theme={null}
  "documents": [
    {
      //...
      "places": [
        {
          "key": "signed_on",
          "type": "recipient_completed_date",
          "recipient_key": "witness",
          "date_format": "MMMM D, YYYY"
        }
      ]
      //...
    }
  ]
  ```
</CodeGroup>