> For the complete documentation index, see [llms.txt](https://docs.sign.enadocapp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sign.enadocapp.com/evia-sign-api/v1/request-types/auto-stamping.md).

# Auto Stamping

## **Implementation Overview**

Evia Sign's Auto Stamping API offers a streamlined and secure solution for the automated placement of annotations, such as signatures, on documents. This API provides a highly customizable process, accepting structured JSON payloads that define the documents, signatories, and the specific stamp positions.

### **API Processing**

Upon receiving the request, Evia Sign's API processes each document, ensuring the accurate placement of specified stamps at designated locations. The system adheres to the provided coordinates and specifications for stamp placement.

This API endpoint enables the creation of a new signature request with auto stamping:

<mark style="color:green;">`POST`</mark> `https://evia.enadocapp.com/_apis/sign/api/Requests?type=3`

#### Headers

| Name          | Type   | Description                                   |
| ------------- | ------ | --------------------------------------------- |
| Authorization | Bearer | Access token should be sent as request header |

{% tabs %}
{% tab title="200: OK " %}
Upon successful creation, a status code of 200 is returned, confirming the successful initiation of the sign request.
{% endtab %}
{% endtabs %}

### **Sample API Request Structure**&#x20;

Below is an example illustrating the structure of a typical API request for Auto Stamping in Evia Sign:

```json
{
  "Message": "Message",
  "Title": "Title",
  "Documents": [
    "2e5cfa87-44d3-4d6d-88e1-3f6586a3c158"
  ],
  "Signatories": [
    {
      "Color": "#7c95f4",
      "Email": "johndoe@email.com",
      "Name": "Jhone Doe",
      "Order": 1,
      "PrivateMessage": "Private Message",
      "signatoryType": 1,
      "OTP": {
        "IsRequired": true,
        "AccessCode": "12345",
        "Type": "1",
        "MobileNumber": ""
      },
      "AutoStamps": [
        {
          "Identifier":"signature1",
          "Color": "#7c95f4",
          "Order": 1,
          "Offset": {
            "X_offset": 0,
            "Y_offset":-50
            
          },
          "StampSize": {
            "Height": 50,
            "Width": 100
          },
          "Type": "signature"
        },
	{
          "Identifier":"text1",
          "Color": "#7c95f4",
          "Order": 1,
          "Offset": {
            "X_offset": 0,
            "Y_offset": -25
            
          },
          "StampSize": {
            "Height": 50,
            "Width": 100
          },
          "Type": "text"
        },
	{
          "Identifier":"email1",
          "Color": "#7c95f4",
          "Order": 1,
          "Offset": {
            "X_offset": 0,
            "Y_offset": -25
            
          },
          "StampSize": {
            "Height": 50,
            "Width": 100
          },
          "Type": "email"
        },
	{
          "Identifier":"Date1",
          "Color": "#7c95f4",
          "Order": 1,
          "Offset": {
            "X_offset": 0,
            "Y_offset": -25
            
          },
          "StampSize": {
            "Height": 50,
            "Width": 100
          },
          "Type": "date"
        },
	{
          "Identifier":"initial1",
          "Color": "#7c95f4",
          "Order": 1,
          "Offset": {
            "X_offset": 0,
            "Y_offset": -50
            
          },
          "StampSize": {
            "Height": 50,
            "Width": 100
          },
          "Type": "initial"
        }
      ]
    }
  ]
}
```

### **Key Elements of the Request:**

* **Message & Title:** General information about the signing request, including a message to signatories and the title of the document.
* **Documents:** An array containing identifiers (Document ID) of the documents to be signed.
* **Signatories:** Details of individuals required to sign, including personal information and signature-related details.
* **Stamps:** Specifies the placement details for each signatory, such as location, size, and type of stamps (e.g., signatures).
