View Template API V2

\r\n

View Template API V2 Introduction

\r\n

This API is used to retrieve detailed template information that already exists in the institution’s account. If you do not pass the correct ‘card-template-id’ for the card that you are trying to retrieve, you will receive an error. All request parameters are mandatory to get the right template information. A “list-templates” API returns limited information about templates and users must use the “view-template” API to get detailed information.

\r\n

Request Format

\r\n

Copy to Clipboard

\r\n

Success Response

\r\n

Copy to Clipboard

{
   "status": "success",
   "code": "S2009",
   "message": "Card template was retrieved successfully.",
   "data": {
       "card-template-id": "CARD_TEMPLATE_ID",
              "institution": "INSTITUTE_NAME",
              "issuance-type": "INSTITUTION_ISSUED",
              "title": "TEMPLATE_TITLE",
              "created-at": "yyyy-mm-ddThh:mm:ss+00:00", //UTC
       "last-updated": "yyyy-mm-ddThh:mm:ss+00:00", //UTC
       "fields": {
           "barcode": [
               {
                   "key": "barcode",
                   "label": "BARCODE_LABEL",
                   "type": "BARCODE_TYPE",
                   "format": "BARCODE_FORMAT",
                   "source": "BARCODE_SOURCE",
                   "source-key": "BARCODE_SOURCE_KEY",
                   "tip": "BARCODE_TOOLTIP",
                   "max-length": 20, // Barcode max length
                   "min-length": 0, // Barcode min length
                   "editable": false, // If barcode editable or not true/false
                   "required": false, // If barcode required or not true/false
                   "value": "BARCODE_VALUE"
               }
           ],
           "image": [
               {
                   "key": "id-photo",
                   "label": "Photo",
                   "type": null,
                   "source": null,
                   "editable": false,
                   "value": null,
                   "max-length": 0,
                   "min-length": 0,
                   "required": false,
                   "format": null,
                   "tip": null
               }
           ],
           "name-fields": [
               {
                   "key": "name",
                   "label": "FIELD_LABEL",
                   "type": "FIELD_TYPE",
                   "source": "FIELD_SOURCE",
                   "editable": true, // If field editable or not (true/false)
                   "value": "FIELD_VALUE",
                   "max-length": 400, // Field value max length
                   "min-length": 0, // Field value min length
                   "required": false, // If field required or not (true/false)
                   "format": "FIELD_FORMAT", 
                   "tip": "FIELD_TOOLTIP"
               }
           ],
           "front-fields": [
               {
                   "key": "front-1",
                   "label": "FIELD_LABEL",
                   "type": "FIELD_TYPE",
                   "source": "FIELD_SOURCE",
                   "editable": true, // If field editable or not (true/false)
                   "value": "FIELD_VALUE",
                   "max-length": 400, // Field value max length
                   "min-length": 0, // Field value min length
                   "required": false, // If field required or not (true/false)
                   "format": "FIELD_FORMAT", 
                   "tip": "FIELD_TOOLTIP"
               }
           ],
           "secondary-fields": [
               {
                   "key": "secondary-1",
                   "label": "FIELD_LABEL",
                   "type": "FIELD_TYPE",
                   "source": "FIELD_SOURCE",
                   "editable": true, // If field editable or not (true/false)
                   "value": "FIELD_VALUE",
                   "max-length": 400, // Field value max length
                   "min-length": 0, // Field value min length
                   "required": false, // If field required or not (true/false)
                   "format": "FIELD_FORMAT", 
                   "tip": "FIELD_TOOLTIP"
               }
           ],
           "back-fields": [
               {
                   "key": "back-1",
                   "label": "FIELD_LABEL",
                   "type": "FIELD_TYPE",
                   "source": "FIELD_SOURCE",
                   "editable": true, // If field editable or not (true/false)
                   "value": "FIELD_VALUE",
                   "max-length": 400, // Field value max length
                   "min-length": 0, // Field value min length
                   "required": false, // If field required or not (true/false)
                   "format": "FIELD_FORMAT", 
                   "tip": "FIELD_TOOLTIP"
               }
           ]
       },
       "authentication-fields": [
           {
               "key": "security-question-1",
               "label": "SECURITY_QUESTION_LABEL",
               "type": "SECURITY_QUESTION_FIELD_TYPE",
               "case-sensitive": false, // If answer is case sensitive or not
               "tip": "SECURITY_QUESTION_TOOLTIP"
           },
           {
               "key": "security-question-2",
               "label": "SECURITY_QUESTION_LABEL",
               "type": "SECURITY_QUESTION_FIELD_TYPE",
               "case-sensitive": false, // If answer is case sensitive or not
               "tip": "SECURITY_QUESTION_TOOLTIP"
           },
           {
               "key": "unique-identifier",
               "label": "UNIQUE_IDENTIFIER_LABEL",
               "type": "UNIQUE_IDENTIFIER_VALUE_TYPE",
               "case-sensitive": false, // If answer is case sensitive or not
               "tip": "UNIQUE_IDENTIFIER_TOOLTIP"
           }
       ],
       "media": {
           "is-upload-allowed": false,
           "allowed-count": 4,
           "files": [
               {
                   "url": "https://dev-app.id123.io/image/dStSSnZiVmVLTHU1dHVVYWZONWJIZw%3D%3D%7CcvvtwkJ7oeDsFet2WxA46QOrP_J9_pHr0UVRl5w5M4GVwKguUd7_A8VOe44ReOTSmgLHoJkhkZB55rIIIW6WySkmP808jWh1aN_Ej-5oSqZJpubrldl7tfjsJrxdHsfnC86xXTBdv7U0B-orBaOuqLcxi5eLsIldleXC_PM-7Ssdo7liif1RZuw3YLzFS9oKrf2b7Ql92gehfWADssUmNTQSSssTLgAKODwAULA96Zs%3D%7CmViCp0MGyfYtONuy_J9x8A%3D%3D",
                   "order": 1
               }
           ]
       }
   }
}

\r\n

Failure Response

\r\n

Copy to Clipboard

Updated on July 14, 2026

ID Card App

Digital ID Card Solution

App Security

Types of ID Cards

App Accessibility

Multi-Language Support

Identity Authentication

Types of ID Card Apps

ID Management Platform

Design Mobile ID Cards

Import Card Data

ID Photo Management

ID Card Printing Software

Issue Digital IDs via Email

Manage Issued ID Cards

Send In-App Messages

Admin Activity Logs

Integrations

Cloud Printing

Card Data Sync

View All Integrations

ID Scanner

Web-Based ID Scanner

ID Card Verification

Search By Name

Scan Logs

Role-Based Scanner Permissions

Supported Barcode Types

Simplify Security by verifying ID Cardholders, their Name and Face.

Resources

Resources

Get In Touch

Support

Company

About Us

Contact Us

Partner With Us

Knowledge Base

View Template API V2 Introduction

Request Format

Success Response

Failure Response

Didn’t find what you were looking for?

ID CARD TYPES

COMPANY

RESOURCES

ACCOUNT

GET SOCIAL