Lister les modèles

Vous pouvez récupérer tous les modèles d’un espace de travail (50 au maximum). Pour ce faire, envoyez une requête à GET /v1/templates et transmettez une série de filtres facultatifs pour affiner votre requête.

curl
https://api.universign.com/v1/templates?size=2 

Paramètres facultatifs

  • size : le nombre de modèles que vous souhaitez récupérer, en commençant par le plus récent. La valeur par défaut est 50.
  • ending_before : la valeur attendue est un identifiant du modèle. À utiliser pour la pagination afin de renvoyer les modèles répertoriés avant le modèle spécifié. Ne pas utiliser si vous transmettez le paramètre starting_after.
  • starting_after : la valeur attendue est un identifiant du modèle. Utilisez-le pour la pagination afin de renvoyer les modèles répertoriés après le modèle spécifié. Ne pas utiliser si vous transmettez le paramètre ending_before.
  • folder_id : renvoie uniquement les modèles associés à cet identifiant du dossier.
  • creator : la valeur attendue est une adresse email. Renvoie uniquement les modèles créés par le membre de l’espace de travail associé à cette adresse email.
  • state : renvoie uniquement les modèles ayant le statut demandé. Valeurs possibles : draft ou published.
  • issuing_entity_id : renvoie uniquement les modèles créés par une entité émettrice donnée.

L’API renvoie la liste de tous les modèles correspondant à votre demande.

{
  "has_more" : false,
  "content" : [ {
    "object" : "template",
    "id" : "tpl_wXzwBdJe91Y6",
    "folder_id" : "fol_JxmJlV5P922X",
    "created_at" : "2024-02-09T13:45:11Z",
    "duration" : 20160,
    "template_name" : "Nouveau modèle",
    "folder_name" : "Default folder",
    "language" : "fr",
    "sender_name_display" : "issuing_entity",
    "creator" : {
      "name" : "Koussai HOUSSINE",
      "email" : "[email protected]",
      "workspace_name" : "DemoWS"
    },
    "state" : "published",
    "publishable" : true,
    "participants" : [ {
      "email" : "[email protected]",
      "phone_number_type" : "suggestion",
      "min_signature_level" : "level1",
      "schedule" : [ 0 ],
      "ongoing_conversation" : false,
      "has_unread_message" : false,
      "waiting_period" : 0,
      "shared_contact" : false,
      "full_name_type" : "suggestion"
    } ],
    "sealers" : [ ],
    "documents" : [ {
      "id" : "doc_Pdk",
      "name" : "Contract template.pdf",
      "name_locked" : true,
      "type" : "final",
      "updatable" : true,
      "deletable" : false,
      "fields" : [ {
        "id" : "fld_gg6M",
        "position" : {
          "page" : 2,
          "x" : 323,
          "y" : 419,
          "width" : 200,
          "height" : 50
        },
        "type" : "signature",
        "built_in" : false,
        "consents" : [ ],
        "optional_consents" : [ ],
        "updatable" : true,
        "deletable" : false
      } ],
      "editable" : true
    } ],
    "field_groups" : [ {
      "id" : "fld_gg6M",
      "type" : "field",
      "fields" : [ "fld_gg6M" ]
    } ],
    "instructions" : {
      "signatures" : [ {
        "signer" : "[email protected]",
        "field" : "fld_gg6M"
      } ],
      "reviews" : [ ],
      "captures" : [ ],
      "sequencing" : [ ],
      "editions" : [ ]
    },
    "actions" : [ {
      "id" : "act_vQ115egKy31gE",
      "actor" : "[email protected]",
      "tasks" : [ {
        "type" : "signature",
        "field" : "fld_gg6M"
      } ]
    } ],
    "action_graph" : {
      "act_vQ115egKy31gE" : [ "end" ],
      "start" : [ "act_vQ115egKy31gE" ]
    },
    "metadata" : { },
    "carbon_copies" : [ ],
    "allow_carbon_copy" : false,
    "last_publication_date" : "2024-02-09T13:45:35Z",
    "last_publisher" : {
      "name" : "Koussai HOUSSINE",
      "email" : "[email protected]",
      "workspace_name" : "DemoWS"
    },
    "issuing_entity" : {
      "active" : true,
      "name" : "DemoWS",
      "id" : "iss_xa1LoEebXQM3"
    }
  }, {
    "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" : "[email protected]",
      "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_5X78AeekMZlvq",
      "actor" : "$1707402147899",
      "tasks" : [ {
        "type" : "signature",
        "field" : "fld_3ZK"
      } ]
    } ],
    "action_graph" : {
      "act_5X78AeekMZlvq" : [ "end" ],
      "start" : [ "act_5X78AeekMZlvq" ]
    },
    "metadata" : { },
    "carbon_copies" : [ ],
    "allow_carbon_copy" : false,
    "last_publication_date" : "2024-02-08T14:57:53Z",
    "last_publisher" : {
      "name" : "Koussai HOUSSINE",
      "email" : "[email protected]",
      "workspace_name" : "DemoWS"
    },
    "issuing_entity" : {
      "active" : true,
      "name" : "Test_entity",
      "id" : "iss_w9nmLe9qzYDy"
    }
  } ]
}

Récupérer un modèle
Créer une transaction à partir d’un modèle
Espace Développeur
Guides
Services
Référence API