Download a Proof

OriginStamp uses a public method to store hashes in a blockchain. This method has been scientifically recognized and published (opens new window).

A timestamp's authenticity can be verified independently of OriginStamp. The verification requires the so-called proof that can be downloaded by using the OriginStamp API.

Using the API

In order to receive the proof, make sure you set the Authorization header x-api-key with your API key.

1. Set up a callback URL

In your API key settings you can set a callback URL that OriginStamp will call once the proof is ready.

Payload:

{
  "notification": {
    "proof": {
      "target": "https://webhook.site/2f62575f-512f-46f3-a461-189eea66b3bd"
    },
    "tree": {
      "target": "https://webhook.site/2f62575f-512f-46f3-a461-189eea66b3bd"
    }
  }
}

2. Request a callback for the proof

Request: POST /v1/proof (opens new window)
Payload:

{
  "currencyId": 0,
  "sha256": "2c5d36be542f8f0e7345d77753a5d7ea61a443ba6a9a86bb060332ad56dba38e"
}

Response:

Expected response is the HTTP status code 202 (Accepted). After a few moments, we will send you a callback to the URL that is provided with your API key settings. The callback will contain the proof.

3. Handle the proof callback

Payload:

{
  "sha256": "b75fbead1eefdd0e4d70f617eccd686a99eee5562309d3e90617b33bd26de2ae",
  "tree": {
    "treeId": "eada2ff6-dc26-4c50-ba47-b5865d1ca6bd",
    "currencyId": 0,
    "currency": "BTC",
    "submitStatus": 3,
    "timestamp": 1710000000000,
    "rootHash": "dc19dddc4e9f8742e31cbbaafe894daa01760f32b11d5cce29224981cef4ba1b",
    "transactionHash": "9f2c93c0edc444f17e6a96c771f34243c0978be4cf90c5d33bb8bfb5a1e5a4f3"
  },
  "branch": {
    "sha": "dc19dddc4e9f8742e31cbbaafe894daa01760f32b11d5cce29224981cef4ba1b",
    "depth": 0,
    "leftSha": "30469fa7b9b7781a0ad8b1504a67b15413a6aab6538c513da5608dcc7162dded",
    "rightSha": "09c1dda272303d58adc9490f26ab4c6c4a7a61de7c418b8a6c1f0711d6ba9b98",
    "left": {
      "sha": "30469fa7b9b7781a0ad8b1504a67b15413a6aab6538c513da5608dcc7162dded",
      "depth": 1,
      "leftSha": "ab1badcf07ce113c47105eefa9c345ced4ad1f1218bc9cd606e0794caaf34301",
      "rightSha": "b75fbead1eefdd0e4d70f617eccd686a99eee5562309d3e90617b33bd26de2ae",
      "right\"": {
        "sha": "b75fbead1eefdd0e4d70f617eccd686a99eee5562309d3e90617b33bd26de2ae",
        "depth": 2
      }
    }
  }
}