Skip to main content
GET
/
v1
/
trails
/
{trailId}
/
versions
/
{versionId}
/
executions
/
{executionId}
cURL
curl --request GET \
  --url https://trails-api.herd.eco/v1/trails/{trailId}/versions/{versionId}/executions/{executionId} \
  --header 'Authorization: <api-key>' \
  --header 'Herd-Trail-App-Id: <herd-trail-app-id>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "steps": [
    {
      "stepNumber": 123,
      "nodeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "txHash": "<string>",
      "txBlockTimestamp": 123,
      "txBlockNumber": 123,
      "createdAt": "<string>",
      "evaluation": {
        "finalInputValues": {},
        "contractAddress": "<string>"
      }
    }
  ]
}
Retrieves detailed information about a specific execution, including all completed steps and their transaction data.

​
Overview

This endpoint returns comprehensive execution data including:
  • Execution metadata (ID, creation/update timestamps)
  • Completed steps with transaction hashes
  • Block timestamps and numbers for each transaction
  • Step evaluations and contract addresses

​
Response Structure

Each execution contains:
  • steps: Array of completed steps
  • stepNumber: The step number in the trail
  • nodeId: UUID of the primary node for this step
  • txHash: Transaction hash for the step
  • txBlockTimestamp: When the transaction was included in a block
  • txBlockNumber: Block number of the transaction
  • evaluation: Contract address and final input values used

​
Use Cases

  • Tracking progress of a user’s trail execution
  • Displaying transaction history for an execution
  • Debugging failed or incomplete executions
  • Showing proof of completion for specific steps

​
Important Notes

  • All executions include a step 0 with a nil transaction hash - filter this out when displaying to users
  • Step numbers start from 1 for actual trail steps
  • Block timestamps can be converted to dates with new Date(timestamp * 1000)

Authorizations

​
Authorization
string
header
required

Enter your bearer token in the format Bearer <token>

Headers

​
Herd-Trail-App-Id
string
required

Application identifier for Herd Trail

Path Parameters

​
trailId
string<uuid>
required

UUIDv7 string

​
versionId
string<uuid>
required

UUIDv7 string

​
executionId
string<uuid>
required

UUIDv7 string

Response

Execution details

​
id
string<uuid>
required

UUIDv7 string

​
createdAt
string
required
​
updatedAt
string
required
​
steps
object[]
required
⌘I