> ## 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.

# Timestamp format

> Customize the date and time format displayed in deliverables for your recipients

The `timestamp_format` property controls how dates and times appear in the deliverable's audit log. It uses MomentJS format tokens.

If not specified, the account's default timestamp format is used. Set your account default in the [dashboard settings](https://dashboard.signatureapi.com/settings/general).

## Setting the timestamp format for an envelope

```json theme={null}
// POST https://api.signatureapi.com/v1/envelopes
// X-API-Key: key_test_...
// Content-Type: application/json

{
  "title": "Service Agreement",
  "timestamp_format": "MM/DD/YYYY HH:mm:ss",
  "documents": [
    //...
  ],
  "recipients": [
    //...
  ]
}
```

## Format tokens

Use these tokens to build a timestamp format string:

| Token  | Description          |
| ------ | -------------------- |
| `YYYY` | Year (four digits)   |
| `MM`   | Month (two digits)   |
| `DD`   | Day (two digits)     |
| `HH`   | Hour (24-hour clock) |
| `hh`   | Hour (12-hour clock) |
| `mm`   | Minutes              |
| `ss`   | Seconds              |

Supported date separators: `/`, `-`, `.`, or a space.
Supported time separators: `:` or `.`.

## Common formats

| Format                | Example output         | Common usage            |
| --------------------- | ---------------------- | ----------------------- |
| `MM/DD/YYYY HH:mm:ss` | 12/31/2025 23:59:59    | United States           |
| `DD/MM/YYYY HH:mm:ss` | 31/12/2025 23:59:59    | Europe, Australia       |
| `YYYY-MM-DD HH:mm:ss` | 2025-12-31 23:59:59    | ISO 8601                |
| `MM/DD/YYYY hh:mm:ss` | 12/31/2025 11:59:59 PM | United States (12-hour) |
| `DD.MM.YYYY HH:mm.ss` | 31.12.2025 23:59.59    | Germany, Eastern Europe |