Skip to content

Read Asset History

Reading commits via API is the simplest way to access asset histories. Here is an example of how you can use the curl command to make a GET request to the specified endpoint using your Capture Token and the Nid of the asset you want to query. If you do not have a Capture Token yet, please follow the instructions and create one.

API Endpoint: https://eohakmlw1xjl7ut.m.pipedream.net

Cost: 0, free to use

Method: GET

Description:
This endpoint allows you to retrieve information about a specific nid. 
Replace "NID_TO_QUERY" with the specific nid you wish to retrieve information about.

Parameters:

Parameter   Type    Required    Description
nid         text    Yes         The nid of the asset to retrieve
testnet         text    No          true to query on Testnet (snow)
tmp_token       text    No              tmp_token to access private assets

Authentication:
The API requires a valid token for Authorization. 
You can pass it in the headers of the request using the following format: 
"Authorization: token YOUR_CAPTURE_TOKEN"

Headers:
Content-Type: application/json
Authorization: token YOUR_CAPTURE_TOKEN

Examples:
curl -X GET -H "Content-Type: application/json" \
            -H "Authorization: token YOUR_CAPTURE_TOKEN" \
            "https://eohakmlw1xjl7ut.m.pipedream.net?nid=NID_TO_QUERY"

Response:
{
    "nid": AssetNid,
    "commits": [
        {
              "transaction": COMMIT_TRANSACTION_HASH,
              "assetTreeCid": ASSET_TREE_NID,
              "assetTreeSha256": ASSET_TREE_SHA256,
              "assetTreeSignature": ASSET_TREE_SIGNATURE,
              "author": AUTHOR_WALLET_ADDRESS,
              "committer": COMMITTER_WALLET_ADDRESS,
              "provider": NID_OF_PROVIDER_PROFILE,
              "timestampCreated": UNIX_TIMESTAMP,
              "action": ACTION_DESCRIPTION,
              "actionName": THE_REAL_ACTION_NAME,
              "actionNid": THE_NID_OF_ACTION,
              "actionResult": ACTION_RESULT_URL,
              "abstract": ACTION_DESCRIPTION
         }, ...
   ]
 }