OriginStamp Docs

# Proof

The authenticity of a timestamp can be verified independently of OriginStamp. The verification requires the so-called proof which can be requested by using the OriginStamp API.

In order to receive the proof, include the Authorization header x-api-key with your API key in the request.

# 1. Set up a callback URL

In the API key settings, configure 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, you will receive a webhook to the URL that is provided with your API key settings.

# 3. Handle the proof callback

Payload:

{
  "sha256": "b75fbead1eefdd0e4d70f617eccd686a99eee5562309d3e90617b33bd26de2ae",
  "tree": {
    "treeId": "eada2ff6-dc26-4c50-ba47-b5865d1ca6bd",
    "currencyId": 0,
    "currency": "BTC",
    "submitStatus": 3,
    "timestamp": 1710000000000,
    "rootSha256": "dc19dddc4e9f8742e31cbbaafe894daa01760f32b11d5cce29224981cef4ba1b",
    "transaction": "9f2c93c0edc444f17e6a96c771f34243c0978be4cf90c5d33bb8bfb5a1e5a4f3"
  },
  "branch": {
    "sha256": "dc19dddc4e9f8742e31cbbaafe894daa01760f32b11d5cce29224981cef4ba1b",
    "depth": 0,
    "leftSha256": "30469fa7b9b7781a0ad8b1504a67b15413a6aab6538c513da5608dcc7162dded",
    "rightSha256": "09c1dda272303d58adc9490f26ab4c6c4a7a61de7c418b8a6c1f0711d6ba9b98",
    "left": {
      "sha256": "30469fa7b9b7781a0ad8b1504a67b15413a6aab6538c513da5608dcc7162dded",
      "depth": 1,
      "leftSha256": "ab1badcf07ce113c47105eefa9c345ced4ad1f1218bc9cd606e0794caaf34301",
      "rightSha256": "b75fbead1eefdd0e4d70f617eccd686a99eee5562309d3e90617b33bd26de2ae",
      "right": {
        "sha256": "b75fbead1eefdd0e4d70f617eccd686a99eee5562309d3e90617b33bd26de2ae",
        "depth": 2
      }
    }
  }
}

← Webhooks →