Submit Hashes

Submit Hashes for Timestamping

Send one or more SHA256 hashes to be timestamped on the Bitcoin blockchain. This endpoint supports up to 25 hashes per request.

Endpoint: POST /api/proof/timestamp/hashes
Description: Use this endpoint to timestamp an array of hashes on the Bitcoin blockchain. The hashes must be in hexadecimal format and 64 characters long.

Headers

x-access-token (string, required): Your API token.

Request Body

Content-Type: application/json

Schema:

{
	"callback_url": "https://example.com/callback",
	"hashes": [
    "ca978112ca1bbdcafac231b39a23dc4da786eff8147c4e72b9807785afee48bb",
    "1a8c3743df10869051e093753221651d69e9f556345492398daf0a944f4fe4a4",
    "149d5f7d5d3622f0495ab57f0646405946bf47f14831a7c9b1a69c41948de000"
  ]
}

hashes (array of strings, required): An array of up to 25 SHA256 hexadecimal hashes.
callback_url (string, optional): Valid URL to receive a POST request with the result in JSON format.

Response

200 OK

The hashes were successfully submitted for timestamping.

{
  "ok": true,
  "files": [
    "ca978112ca1bbdcafac231b39a23dc4da786eff8147c4e72b9807785afee48bb",
    "1a8c3743df10869051e093753221651d69e9f556345492398daf0a944f4fe4a4",
    "149d5f7d5d3622f0495ab57f0646405946bf47f14831a7c9b1a69c41948de000"
  ]
}

400 Bad Request

The request was invalid or violated the endpoint's constraints (e.g., exceeding the hash limit).
```
{
  "ok": false,
  "msg": "A maximum of 25 hashes per request is allowed."
}
```
500 Internal Server Error

The server encountered an unexpected issue while processing the request.
```
{
  "ok": false,
  "msg": "Internal server error. Please try again later."
}
```

Example Request (Using `curl`)

curl -X POST https://app.simpleproof.com/api/proof/timestamp/hashes \
-H "Content-Type: application/json" \
-H "x-access-token: YOUR_TOKEN" \
-d '{
	"callback_url": "https://example.com/callback",
	"hashes": [
    "ca978112ca1bbdcafac231b39a23dc4da786eff8147c4e72b9807785afee48bb",
    "1a8c3743df10869051e093753221651d69e9f556345492398daf0a944f4fe4a4",
    "149d5f7d5d3622f0495ab57f0646405946bf47f14831a7c9b1a69c41948de000"
  ]
}'

Notes