> For the complete documentation index, see [llms.txt](https://docs.vida.id/identity-stack/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vida.id/identity-stack/sign/digital-signature/vsp-openapi/api-reference/stamping-e-meterai.md).

# Stamping e-Meterai

## Create Envelope with e-Meterai

Please refer to [Create Envelope API](broken://pages/pTQorKzqnISI4zOYDWZ5) with field type `E-Meterai`

***

## Get e-Meterai Document Type Codes

The e-Meterai Document Type Code API is  used to retrieve specific codes associated with of documents that require E-Meterai.

{% hint style="info" %}
The [*E-Meterai Document Type Codes Table*](#e-meterai-document-type-codes) includes a comprehensive list of all document type codes along with their corresponding document names
{% endhint %}

***

### API Description

<mark style="color:blue;">`GET`</mark> `{environment-url}/core/external-api/rest/v1/emeterai/doc-types`

***

#### Headers

| Name                                            | Type   | Description                                                                                                                                                               |
| ----------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Content-Type<mark style="color:red;">\*</mark>  | String | \*/\*                                                                                                                                                                     |
| Authorization<mark style="color:red;">\*</mark> | String | <p>Bearer Access Token<br><br>Get the access token by calling the</p><p><a href="/pages/XOKnwALziwtzopCd8Bb1#api-description"><strong>Authentication</strong></a> API</p> |

***

#### Response

HTTP Status Code: `200`

Status : `SUCCESS`

**JSON Response**

```json
{
    "success": true,
    "data": [
        {
            "codeDocument": "VD001",
            "nameDocument": "Dokumen pelunasan utang (lebih dari 5 juta)"
        },
        {
            "codeDocument": "VD002",
            "nameDocument": "Dokumen Transaksi"
        },
        {
            "codeDocument": "VD003",
            "nameDocument": "Surat Keterangan"
        },
        {
            "codeDocument": "VD004",
            "nameDocument": "Surat Pernyataan"
        },
        {
            "codeDocument": "VD005",
            "nameDocument": "Surat Lainnya"
        },
        {
            "codeDocument": "VD006",
            "nameDocument": "Surat Berharga"
        },
        {
            "codeDocument": "VD007",
            "nameDocument": "Dokumen penerimaan uang (lebih dari 5 juta)"
        },
        {
            "codeDocument": "VD008",
            "nameDocument": "Akta Notaris"
        },
        {
            "codeDocument": "VD009",
            "nameDocument": "Dokumen Lelang"
        },
        {
            "codeDocument": "VD010",
            "nameDocument": "Surat Perjanjian"
        },
        {
            "codeDocument": "VD011",
            "nameDocument": "Dokumen pernyataan jumlah uang lebih dari 5jt"
        },
        {
            "codeDocument": "VD012",
            "nameDocument": "Akta Pejabat"
        },
        {
            "codeDocument": "VD013",
            "nameDocument": "Dokumen lain-lain"
        }
    ]
}
```

***

## Get E-Meterai Quota

The *Get E-Meterai Quota* API is used to retrieve the available e-meterai quota.

***

### API Description

<mark style="color:blue;">`GET`</mark> `{environment-url}/core/external-api/rest/v1/emeterai/quota`

#### Headers

| Name                                            | Type   | Description                                                                                                                                                               |
| ----------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Content-Type<mark style="color:red;">\*</mark>  | String | \*/\*                                                                                                                                                                     |
| Authorization<mark style="color:red;">\*</mark> | String | <p>Bearer Access Token<br><br>Get the access token by calling the</p><p><a href="/pages/XOKnwALziwtzopCd8Bb1#api-description"><strong>Authentication</strong></a> API</p> |

***

#### Response

HTTP Status Code: `200`

Status : `SUCCESS`

**JSON Response**

```json
{
    "success": true,
    "data": {
        "available_quota": 10
    }
}
```

***

## E-Meterai Document Type Codes

| Code  | English Name                                | Indonesian Name                               |
| ----- | ------------------------------------------- | --------------------------------------------- |
| VD001 | Debt settlement document (over 5 million)   | Dokumen pelunasan utang (lebih dari 5 juta)   |
| VD002 | Transaction Document                        | Dokumen Transaksi                             |
| VD003 | Certificate                                 | Surat Keterangan                              |
| VD004 | Statement Letter                            | Surat Pernyataan                              |
| VD005 | Miscellaneous Letter                        | Surat Lainnya                                 |
| VD006 | Valuable Letter                             | Surat Berharga                                |
| VD007 | Receipt document (over 5 million)           | Dokumen penerimaan uang (lebih dari 5 juta)   |
| VD008 | Notarial Deed                               | Akta Notaris                                  |
| VD009 | Auction Document                            | Dokumen Lelang                                |
| VD010 | Agreement Letter                            | Surat Perjanjian                              |
| VD011 | Money declaration document (over 5 million) | Dokumen pernyataan jumlah uang lebih dari 5jt |
| VD012 | Official Deed                               | Akta Pejabat                                  |
| VD013 | Other Documents                             | Dokumen lain-lain                             |
