Retrieving a template allows you to figure out the parameters requested by the template creator and that need to be set while creating a transaction.
To retrieve a template, send a request to GET /v1/templates/{template_id}.
curl
https://api.universign.com/v1/templates/tpl_agMgvOzLya3k
The API returns a template object.
{
"object" : "template",
"id" : "tpl_agMgvOzLya3k",
"folder_id" : "fol_JxmJlV5P922X",
"created_at" : "2023-10-02T09:07:07Z",
"duration" : 20160,
"template_name" : "New template",
"folder_name" : "Default folder",
"transaction_name" : "Contract John",
"language" : "fr",
"sender_name_display" : "name_email_issuing_entity",
"creator" : {
"name" : "Demo Workspace",
"email" : "koussai.houssine@universign.com",
"workspace_name" : "DemoWS"
},
"state" : "published",
"publishable" : true,
"participants" : [ {
"email" : "$1707402147899",
"designation" : "Insured",
"phone_number_type" : "suggestion",
"request_phone_number" : false,
"min_signature_level" : "level1",
"schedule" : [ 0 ],
"ongoing_conversation" : false,
"has_unread_message" : false,
"waiting_period" : 0,
"shared_contact" : false,
"request_full_name" : false,
"full_name_type" : "suggestion"
} ],
"sealers" : [ ],
"documents" : [ {
"id" : "doc_aX4",
"name" : "Specimen 1.pdf",
"name_locked" : true,
"type" : "specimen",
"updatable" : true,
"deletable" : false,
"fields" : [ {
"id" : "fld_3ZK",
"position" : {
"page" : 1,
"x" : 192,
"y" : 95,
"width" : 200,
"height" : 50
},
"type" : "signature",
"built_in" : false,
"consents" : [ ],
"optional_consents" : [ ],
"updatable" : true,
"deletable" : false
} ],
"editable" : true
} ],
"field_groups" : [ {
"id" : "fld_3ZK",
"type" : "field",
"fields" : [ "fld_3ZK" ]
} ],
"instructions" : {
"signatures" : [ {
"signer" : "$1707402147899",
"field" : "fld_3ZK"
} ],
"reviews" : [ ],
"captures" : [ ],
"sequencing" : [ ],
"editions" : [ ]
},
"actions" : [ {
"id" : "act_D2Zzl7rVMeQ3",
"actor" : "$1707402147899",
"tasks" : [ {
"type" : "signature",
"field" : "fld_3ZK"
} ]
} ],
"action_graph" : {
"act_D2Zzl7rVMeQ3" : [ "end" ],
"start" : [ "act_D2Zzl7rVMeQ3" ]
},
"metadata" : { },
"carbon_copies" : [ ],
"allow_carbon_copy" : false,
"last_publication_date" : "2024-02-08T14:57:53Z",
"last_publisher" : {
"name" : "Koussai HOUSSINE",
"email" : "koussai.houssine@universign.com",
"workspace_name" : "DemoWS"
},
"issuing_entity" : {
"active" : true,
"name" : "Test_entity",
"id" : "iss_w9nmLe9qzYDy"
}
}
