v1

latestOpenAPI 3.0.3MIT2026-07-24122271451.2 KB
Templates

Template Details

Get details about a template by id. Details include:

  • Basic template information (name, author, etc)
  • Roles
  • All fields with values
  • All tokens with values
  • Pricing information (pricing tables, products, quotes)
  • Template metadata
  • Template tags
  • Content placeholders
  • Modification timestamps. Note that date_modified means any changes associated with the template roles, while content_date_modified logs any changes in the template content.
get/public/v1/templates/{id}/details

Path parameters

idstring required

Template ID

Response

OK

idstring
namestring
folder_uuidstring
date_createdstring
date_modifiedstring
content_date_modifiedstring
metadataobject
tagsstring[]
versionstring

Example response

{
  "id": "SkXXMTBsLB5TLPagPTm5yC",
  "name": "API Sample Document from PandaDoc Template",
  "folder_uuid": "b6RGTSGwJw838L2KZqckpD",
  "date_created": "2021-03-10T07:28:47.440256Z",
  "date_modified": "2021-03-10T07:28:47.442256Z",
  "content_date_modified": "2021-10-23T21:07:04.147345Z",
  "created_by": {
    "id": "b6RGTSGwJw838L2KZqckpD",
    "email": "jane@example.com",
    "first_name": "Jane",
    "last_name": "Roe",
    "avatar": "https://pd-live-media.s3.amazonaws.com/users/000GTSGwJw000L2KZqc000/avatar.jpg"
  },
  "metadata": {
    "public_template": true
  },
  "tokens": [
    {
      "name": "Document.GrandTotal",
      "value": "$29.99"
    }
  ],
  "fields": [
    {
      "uuid": "74bcb05d-e4cd-458d-bc1d-671c2be8b221",
      "name": "Favorite.Color",
      "title": "",
      "placeholder": "Favorite Color",
      "value": "",
      "assigned_to": {
        "id": "HHaFsYvJCqMvdAtXwGcyL",
        "name": "user",
        "preassigned_person": {
          "email": "test@panddoc.com",
          "type": "preassigned contact"
        },
        "type": "recipient"
      },
      "merge_field": "Favorite.Color",
      "field_id": "text1",
      "type": "text",
      "is_filled": false
    }
  ],
  "pricing": {
    "tables": [
      {
        "name": "Pricing Table",
        "id": "065c5cbc-a065-4843-ba17-028e63779605",
        "total": "11500",
        "summary": {
          "subtotal": "11500",
          "total": "11500",
          "discount": "0",
          "tax": "0",
          "fee": "0"
        },
        "items": [
          {
            "qty": "10",
            "name": "Annual license",
            "price": "100",
            "description": "1 year subscription",
            "custom_fields": {},
            "custom_columns": {
              "Images": "",
              "Cost": "",
              "Subtotal": ""
            },
            "subtotal": "10000",
            "options": {},
            "sale_price": "1000",
            "taxes": {},
            "discounts": {},
            "fees": {},
            "merged_data": {
              "custom_name": "SomeName",
              "custom_description": "SomeCustomDescription",
              "custom_price": "10.99",
              "custom_qty": "1.00",
              "custom_sku": "Test",
              "custom_tax": {
                "value": "10",
                "type": "percent"
              },
              "custom_fee": {
                "value": "10",
                "type": "percent"
              },
              "custom_discount": {
                "value": "10",
                "type": "percent"
              },
              "custom_text": "Some other",
              "Cost": null,
              "Subtotal": "26.38",
              "fluffiness": "Fluffiness",
              "Other_field": "SomeText"
            }
          }
        ],
        "currency": "USD"
      }
    ],
    "quotes": [
      {
        "id": "4b011d86-286b-4f86-b697-90a6ad3f1489",
        "currency": "USD",
        "total": "900",
        "summary": {
          "total": "900",
          "subtotal": "1000",
          "one_time_subtotal": "500",
          "recurring_subtotal": [
            {
              "billing_cycle": "monthly",
              "value": "500"
            }
          ],
          "total_discount": "100",
          "total_contract_value": "1900"
        },
        "sections": [
          {
            "summary": {
              "total": "1000",
              "subtotal": "1000",
              "one_time_subtotal": "500",
              "recurring_subtotal": [
                {
                  "billing_cycle": "monthly",
                  "value": "500"
                }
              ],
              "total_section_value": "1900"
            },
            "items": [
              {
                "qty": "1",
                "price": "500",
                "overall_total": "1000"
              }
            ],
            "total": "1000"
          }
        ]
      }
    ],
    "total": "11500"
  },
  "tags": [
    "tpl-tag-one",
    "tpl-tag-two"
  ],
  "roles": [
    {
      "id": "HHaFsYvJCqMvdAtXwGcyLn",
      "name": "Sender",
      "preassigned_person": {
        "email": "jane@example.com",
        "first_name": "Jane",
        "last_name": "Doe",
        "type": "preassigned contact",
        "placeholder_name": "Employee",
        "placeholder_source": "bamboohr",
        "members": [
          {
            "email": "alice@example.com",
            "first_name": "Alice",
            "last_name": "Johnson"
          }
        ]
      }
    }
  ],
  "version": "2",
  "content_placeholders": [
    {
      "uuid": "305eca46-f5be-435b-bbb4-f4dacf3896f5",
      "block_id": "Content Placeholder",
      "description": "lick here to add content library items"
    }
  ],
  "images": [
    {
      "name": "image",
      "block_uuid": "c0096462-7899-4ae8-b92e-a5643e6a0223",
      "urls": [
        "https://api.pandadoc.com/images/Pf7QMxFzcCkMSVXnCZfwcJ/2e6131b32d6949e4a093c36bafccd194"
      ]
    }
  ]
}