Template details

get/v1/template/properties

The template entire details, such as its title, description, role details, added form fields .. etc., can be fetched by specifying the template ID.

On successful get, the entire template details will be returned.

Code snippet

curl -X 'GET' \ 'https://api.boldsign.com/v1/template/properties?templateId=8f59295d-xxxx-xxxx-xxxx-e7dc88cfff2c' \
     -H 'accept: application/json' \
     -H 'X-API-KEY: {your-api-key}'

var apiClient = new ApiClient("https://api.boldsign.com", "{your API key}");
var templateClient = new TemplateClient(apiClient);
var templateProperties = templateClient.GetProperties("8f59295d-xxxx-xxxx-xxxx-e7dc88cfff2c");

import requests

url = "https://api.boldsign.com/v1/template/properties?templateId=8f59295d-xxxx-xxxx-xxxx-e7dc88cfff2c"

payload={}
headers = {
  'accept': 'application/json',
  'X-API-KEY': '{your-api-key}'
}

response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)

const axios = require('axios');
const response = await axios.get('https://api.boldsign.com/v1/template/properties', {
    params: {
        'templateId': '8f59295d-xxxx-xxxx-xxxx-e7dc88cfff2c'
    },
    headers: {
        'accept': 'application/json',
        'X-API-KEY': '{your API key}'
    }
});

Query parameters

templateIdstringRequired

The ID of the template from which the details should be fetched.

Example response

200 Success

{
  "templateId": "8f59295d-xxxx-xxxx-xxxx-e7dc88cfff2c",
  "title": "title of the template",
  "description": "description",
  "documentTitle": "title of the document",
  "documentMessage": "Agreement",
  "files": [
    {
      "documentName": "Agreement.pdf",
      "order": 0,
      "pageCount": 6
    }
  ],
  "roles": [
    {
      "name": "HR",
      "index": 1,
      "defaultSignerName": "Hank White",
      "defaultSignerEmail": "hankwhite@cubeflakes.com",
      "signerOrder": 1,
      "signerType": "Signer",
      "hostEmail": "",
      "hostName": "",
      "language": 1,
      "allowRoleEdit": true,
      "allowRoleDelete": true,
      "enableAccessCode": false,
      "enableEmailOTP": false,
      "imposeAuthentication": "None",
      "formFields": [
        {
          "id": "Signature1",
          "fieldType": "signature",
          "value": "",
          "font": "Helvetica",
          "isRequired": true,
          "isReadOnly": false,
          "lineHeight": 14,
          "fontSize": 13,
          "fontHexColor": "#000000",
          "isUnderLineFont": false,
          "isItalicFont": false,
          "isBoldFont": false,
          "groupName": "",
          "placeholder": "",
          "validationtype": "None",
          "validationCustomRegex": "",
          "validationCustomRegexMessage": null,
          "dateFormat": "",
          "imageInfo": null,
          "attachmentInfo": null,
          "editableDateFieldSettings": null,
          "conditionalRules": [],
          "dropdownOptions": [],
          "bounds": {
            "x": 343.9798,
            "y": 169.93939,
            "width": 124.0,
            "height": 32.0
          },
          "pageNumber": 1,
          "dataSyncTag": ""
        }
      ],
      "enableEditRecipients": true,
      "enableDeleteRecipients": true
    },
    {
      "name": "Sales",
      "index": 2,
      "defaultSignerName": "Alex Gayle",
      "defaultSignerEmail": "alexgayle@cubeflakes.com",
      "signerOrder": 2,
      "signerType": "Signer",
      "hostEmail": "",
      "hostName": "",
      "language": 1,
      "allowRoleEdit": true,
      "allowRoleDelete": true,
      "enableAccessCode": false,
      "enableEmailOTP": false,
      "imposeAuthentication": "None",
      "formFields": [
        {
          "id": "Signature2",
          "fieldType": "signature",
          "value": "",
          "font": "Helvetica",
          "isRequired": true,
          "isReadOnly": false,
          "lineHeight": 14,
          "fontSize": 13,
          "fontHexColor": "#000000",
          "isUnderLineFont": false,
          "isItalicFont": false,
          "isBoldFont": false,
          "groupName": "",
          "placeholder": "",
          "validationtype": "None",
          "validationCustomRegex": "",
          "validationCustomRegexMessage": null,
          "dateFormat": "",
          "imageInfo": null,
          "attachmentInfo": null,
          "editableDateFieldSettings": null,
          "conditionalRules": [],
          "dropdownOptions": [],
          "bounds": {
            "x": 211.65657,
            "y": 253.77777,
            "width": 124.0,
            "height": 32.0
          },
          "pageNumber": 1,
          "dataSyncTag": ""
        }
      ],
      "enableEditRecipients": true,
      "enableDeleteRecipients": true
    }
  ],
  "commonFields": [],
  "cCDetails": [],
  "brandId": "e56e3625-xxxx-xxxx-be4d-9184cb5e22b9",
  "allowMessageEditing": true,
  "allowNewRoles": true,
  "enableReassign": true,
  "EnablePrintAndSign": false,
  "enableSigningOrder": false,
  "createdDate": 1655981185,
  "createdBy": {
    "emailAddress": "richard@cubeflakes.com",
    "name": "Richard"
  },
  "sharedTemplateDetail": [],
  "documentInfo": [
    {
      "language": 1,
      "title": "title",
      "description": "description"
    }
  ]
}