Retrieve an execution | Runstamp Docs

GET/api/v2/executions/{id}

Headers

Authorization string required

Bearer pj_live_… Raw keys are shown only when created. The x-api-key header is an alternative transport.

Key scope: execution:read.

Path parameters

id string (uuid) required

Response

200 OK Exact environment-scoped execution view.

execution_id string (uuid) required
environment_id string (uuid) required
status enum required: queued running succeeded failed blocked cancelling cancelled
operation string required
format string required
requested_units integer required
overage_authorized boolean required
contract_version const "delivery.v2" required
metering_contract_version const "successful-artifact.v2" required
receipt_schema_version const "execution-receipt.v2" required
request_hash string (sha256) required
input_hash string (sha256) required
options_hash string (sha256) required
current_attempt_number integer required
created_at string (date-time) required
terminal_at string,null required
events array of object required
artifacts array of object required
receipt one of several shapes required

Errors

Status	When
`401`	Missing, invalid, unentitled, or no-longer-accepted API key.
`403`	The key lacks the required execution scope.
`404`	The organization/environment-scoped resource was not found.
`503`	Launch control is held or execution authority is unavailable.

curl \
  -H "Authorization: Bearer pj_live_YOUR_KEY" \
https://runstamp.com/api/v2/executions/8f4fa0a3-f907-41f5-babe-5762f974cb83

Response 200 OK

JSON

{
  "execution_id": "8f4fa0a3-f907-41f5-babe-5762f974cb83",
  "environment_id": "8f4fa0a3-f907-41f5-babe-5762f974cb83",
  "status": "queued",
  "operation": "OPERATION",
  "format": "FORMAT",
  "requested_units": 1,
  "overage_authorized": false,
  "contract_version": "delivery.v2",
  "metering_contract_version": "successful-artifact.v2",
  "receipt_schema_version": "execution-receipt.v2",
  "request_hash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  "input_hash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  "options_hash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  "current_attempt_number": 0,
  "created_at": "2026-10-12T09:30:00.000Z",
  "terminal_at": {},
  "events": [
    {
      "id": "8f4fa0a3-f907-41f5-babe-5762f974cb83",
      "sequence": 1,
      "event_type": "EVENT_TYPE",
      "status": {},
      "attempt_id": {},
      "payload": {},
      "occurred_at": "2026-10-12T09:30:00.000Z"
    }
  ],
  "artifacts": [
    {
      "id": "8f4fa0a3-f907-41f5-babe-5762f974cb83",
      "kind": "KIND",
      "format": "FORMAT",
      "label": "LABEL",
      "content_type": "CONTENT_TYPE",
      "byte_length": 1,
      "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
      "metadata": {},
      "created_at": "2026-10-12T09:30:00.000Z",
      "download": {}
    }
  ],
  "receipt": {}
}

Response

200 OK Exact environment-scoped execution view.

execution_id string (uuid) required

environment_id string (uuid) required

status enum required

queued running succeeded failed blocked cancelling cancelled

operation string required

format string required

requested_units integer required

overage_authorized boolean required

contract_version const "delivery.v2" required

metering_contract_version const "successful-artifact.v2" required

receipt_schema_version const "execution-receipt.v2" required

request_hash string (sha256) required

input_hash string (sha256) required

options_hash string (sha256) required

current_attempt_number integer required

created_at string (date-time) required

terminal_at string,null required

events array of object required

artifacts array of object required

receipt one of several shapes required

Status

When

401

Missing, invalid, unentitled, or no-longer-accepted API key.

403

The key lacks the required execution scope.

404

The organization/environment-scoped resource was not found.

503

Launch control is held or execution authority is unavailable.

{ "execution_id": "8f4fa0a3-f907-41f5-babe-5762f974cb83", "environment_id": "8f4fa0a3-f907-41f5-babe-5762f974cb83", "status": "queued", "operation": "OPERATION", "format": "FORMAT", "requested_units": 1, "overage_authorized": false, "contract_version": "delivery.v2", "metering_contract_version": "successful-artifact.v2", "receipt_schema_version": "execution-receipt.v2", "request_hash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08", "input_hash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08", "options_hash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08", "current_attempt_number": 0, "created_at": "2026-10-12T09:30:00.000Z", "terminal_at": {}, "events": [ { "id": "8f4fa0a3-f907-41f5-babe-5762f974cb83", "sequence": 1, "event_type": "EVENT_TYPE", "status": {}, "attempt_id": {}, "payload": {}, "occurred_at": "2026-10-12T09:30:00.000Z" } ], "artifacts": [ { "id": "8f4fa0a3-f907-41f5-babe-5762f974cb83", "kind": "KIND", "format": "FORMAT", "label": "LABEL", "content_type": "CONTENT_TYPE", "byte_length": 1, "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08", "metadata": {}, "created_at": "2026-10-12T09:30:00.000Z", "download": {} } ], "receipt": {} }