Bulk Decrypt Data

This API decrypts multiple ciphertext values across one or more encryption configurations in a single request. Each encryption configuration is identified by its unique function_id, and the API returns the corresponding plaintext for each ciphertext item.

---

Endpoint Details

URL	/v1/crypto/bulk-decrypt
Method	POST
Authorization	Bearer Token

---

Request Headers

Header	Type	Description
Content-Type	String	Must be application/json

---

Request Body

Use the following format to make a request:

JSON Request

{
  "data": [
    {
      "function_id": "ab063593-5dd8-4b9c-a24b-fbd66190cc85",
      "items": [
        {
          "ciphertext": "v1:7qMnVsYUWv8SG3FpxrLd0w3zNr3ATtWeUWdRmH7nXBUAS9A="
        },
        {
          "ciphertext": "v1:+ekQmVs1Dk2b01JI7BYb2RLBcB6y48gtE3LV8sNGVRCCrvuO4g=="
        }
      ]
    }
  ]
}

---

Parameters

Parameter	Type	Description
data	Array	List of decryption requests grouped by encryption configuration
function_id	UUID	Unique identifier of the encryption configuration used to decrypt the data
items	Array	List of ciphertext values to be decrypted using the specified encryption configuration
plaintext	String	Encrypted data to be decrypted

---

Response

Here is an example response after the request has been successfully processed:

Response

{
    "data": [
        {
            "security_config_id": "ab063593-5dd8-4b9c-a24b-fbd66190cc85",
            "security_config_type": 1,
            "items": [
                {
                    "ciphertext": "v1:7qMnVsYUWv8SG3FpxrLd0w3zNr3ATtWeUWdRmH7nXBUAS9A=",
                    "plaintext": "jakarta",
                    "success": true
                },
                {
                    "ciphertext": "v1:+ekQmVs1Dk2b01JI7BYb2RLBcB6y48gtE3LV8sNGVRCCrvuO4g==",
                    "plaintext": "tangerang",
                    "success": true
                }
            ]
        }
    ]
}

---

Field Descriptions

Field	Type	Description
security_config_id	UUID	Unique identifier of the encryption configuration used to decrypt the data
security_config_type	Integer	Type of the security configuration
items	Array	List of decryption results
ciphertext	String	Encrypted input provided in the request
plaintext	String	Decrypted plaintext generated from the corresponding ciphertext
success	Boolean	Indicates whether the decryption operation completed successfully

---

info

• A valid Bearer Token is required to access this endpoint.
• Each function_id must refer to an existing encryption configuration.
• The security_config_type field indicates the type of security configuration used:
  • 1 = Encryption
  • 2 = Tokenization
  • 3 = Masking
• A single request can include multiple encryption configurations, each containing one or more ciphertext values to decrypt.
• The API returns the decrypted plaintext for each successfully processed ciphertext.