Get an Execution Intent and its status

GET

execution-intents

{businessTransactionId}

curl --request GET \
  --url https://parmana-api-real.vercel.app/execution-intents/{businessTransactionId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://parmana-api-real.vercel.app/execution-intents/{businessTransactionId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://parmana-api-real.vercel.app/execution-intents/{businessTransactionId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://parmana-api-real.vercel.app/execution-intents/{businessTransactionId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://parmana-api-real.vercel.app/execution-intents/{businessTransactionId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://parmana-api-real.vercel.app/execution-intents/{businessTransactionId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "intent": {
    "intentId": "b41fe9b9-5730-4d34-aab0-4ab63ae69d3b",
    "businessTransactionId": "4c2eb3b2-3382-4bc2-bf22-2a072e6cf428",
    "decisionId": "20b4e030-09cd-4447-86fc-b73279d23121",
    "authorizationId": "5977535b-d887-423d-b422-01ece1fc7bf1",
    "policyName": "customer-refund",
    "policyVersion": "1.0.0",
    "policyContentHash": "6a2e92fbde0f4c5dc56b4e202bf45ce24c99e565cf3ddaacaa21a11c71b7e1ea",
    "signalsHash": "e22a7b9fd6e0a39e28521f9ffb726d6a57499236055fa6ff2caabd2268f4a395",
    "businessTransactionHash": "9df286daf38c6eba272f47153e0fb3efef5ee61d778f6baecd5a53861763763a",
    "action": "paytm:refund",
    "target": "DRY-ORDER-1789969223742",
    "submittedBy": "sandbox-agent",
    "grantedCapability": "paytm:refund",
    "createdAt": "2026-09-21T05:40:28.434Z",
    "intentHash": "13922de380518d582c6bb3e88b1d88908e71565f191119f4cadc7de4e30cf5ed",
    "signature": {
      "keyId": "default",
      "value": "UhXnkSnm5A3QU4CVrKGbP3FcTWkShnitn86psJprJpqgEBnsXWzDcZ+ktSO0FJek1X+n9DvO3SjR+WvSofS1CA==",
      "signedAt": "2026-09-21T05:40:28.555Z",
      "algorithm": "ed25519"
    }
  },
  "status": {
    "state": "FINALIZED",
    "releasedAt": "2026-09-21T05:40:32.743Z",
    "finalizedAt": "2026-09-21T05:40:32.855Z",
    "finalizationMode": "INLINE",
    "trustRecordId": "a3c8d068-af6a-46c7-9976-e43612d5ab9c"
  }
}

{
  "error": "authentication required"
}

{
  "error": "Execution Intent not found."
}

Authorizations

Authorization

string

header

required

Caller API key issued by scripts/generate-api-key.ts. Sent as Authorization: Bearer . Verified against a stored SHA-256 hash in constant time by packages/api/src/auth/StaticKeyAuthenticator.ts. Required on every route not listed as exempt in this document's top-level description. See /api-reference/authentication.

Path Parameters

businessTransactionId

string

required

Response

Execution Intent found.

Response returned by GET /execution-intents/{businessTransactionId}: the signed Execution Intent and its operational status. The saved release context used to rebuild a Trust Record is internal and is never returned.

intent

Execution Intent · object

required

A signed statement, made and stored BEFORE an action is released to a connector, of exactly what is about to be released (ADR-0012). It exists so that an action that was released always has signed evidence behind it, even when the Execution Trust Record cannot be produced afterwards. It contains only facts that exist before release: never the execution result, and never the raw intent parameters (the businessTransactionHash binds the intent to them). It is a separate record from the Execution Trust Record, which keeps its own format. An intent proves what was about to be released. It does NOT prove the action was released or what its result was. At most one Execution Intent exists per businessTransactionId.

Show child attributes

Example:

{
  "intentId": "b41fe9b9-5730-4d34-aab0-4ab63ae69d3b",
  "businessTransactionId": "4c2eb3b2-3382-4bc2-bf22-2a072e6cf428",
  "decisionId": "20b4e030-09cd-4447-86fc-b73279d23121",
  "authorizationId": "5977535b-d887-423d-b422-01ece1fc7bf1",
  "policyName": "customer-refund",
  "policyVersion": "1.0.0",
  "policyContentHash": "6a2e92fbde0f4c5dc56b4e202bf45ce24c99e565cf3ddaacaa21a11c71b7e1ea",
  "signalsHash": "e22a7b9fd6e0a39e28521f9ffb726d6a57499236055fa6ff2caabd2268f4a395",
  "businessTransactionHash": "9df286daf38c6eba272f47153e0fb3efef5ee61d778f6baecd5a53861763763a",
  "action": "paytm:refund",
  "target": "DRY-ORDER-1789969223742",
  "submittedBy": "sandbox-agent",
  "grantedCapability": "paytm:refund",
  "createdAt": "2026-09-21T05:40:28.434Z",
  "intentHash": "13922de380518d582c6bb3e88b1d88908e71565f191119f4cadc7de4e30cf5ed",
  "signature": {
    "keyId": "default",
    "value": "UhXnkSnm5A3QU4CVrKGbP3FcTWkShnitn86psJprJpqgEBnsXWzDcZ+ktSO0FJek1X+n9DvO3SjR+WvSofS1CA==",
    "signedAt": "2026-09-21T05:40:28.555Z",
    "algorithm": "ed25519"
  }
}

status

Execution Intent Status · object

required

Operational status kept next to a signed Execution Intent. It is NOT part of what is signed, so it changes as the request progresses. PREPARED: the intent is signed and stored, and the action may or may not have been released. An intent that stays PREPARED needs reconciliation with the connector. RELEASED: the release stage returned and the execution context was saved, so the Trust Record can be rebuilt. FINALIZED: a signed Execution Trust Record exists for this transaction. ERRORED: the release stage raised an error. The action may still have been executed, so the outcome is unknown and must be reconciled. RESOLVED: a verified human reconciled a PREPARED or ERRORED intent at the connector and closed it with POST /execution-intents/{businessTransactionId}/resolve, recording what they found and a note. The resolution is an attributed operator statement stored in this unsigned status. It is NOT tamper evident and it is not a Trust Record.

Show child attributes

Example:

{
  "state": "FINALIZED",
  "releasedAt": "2026-09-21T05:40:32.743Z",
  "finalizedAt": "2026-09-21T05:40:32.855Z",
  "finalizationMode": "INLINE",
  "trustRecordId": "a3c8d068-af6a-46c7-9976-e43612d5ab9c"
}

Get an Execution Intent and its status

curl --request GET \
  --url https://parmana-api-real.vercel.app/execution-intents/{businessTransactionId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://parmana-api-real.vercel.app/execution-intents/{businessTransactionId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://parmana-api-real.vercel.app/execution-intents/{businessTransactionId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://parmana-api-real.vercel.app/execution-intents/{businessTransactionId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://parmana-api-real.vercel.app/execution-intents/{businessTransactionId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://parmana-api-real.vercel.app/execution-intents/{businessTransactionId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "intent": {
    "intentId": "b41fe9b9-5730-4d34-aab0-4ab63ae69d3b",
    "businessTransactionId": "4c2eb3b2-3382-4bc2-bf22-2a072e6cf428",
    "decisionId": "20b4e030-09cd-4447-86fc-b73279d23121",
    "authorizationId": "5977535b-d887-423d-b422-01ece1fc7bf1",
    "policyName": "customer-refund",
    "policyVersion": "1.0.0",
    "policyContentHash": "6a2e92fbde0f4c5dc56b4e202bf45ce24c99e565cf3ddaacaa21a11c71b7e1ea",
    "signalsHash": "e22a7b9fd6e0a39e28521f9ffb726d6a57499236055fa6ff2caabd2268f4a395",
    "businessTransactionHash": "9df286daf38c6eba272f47153e0fb3efef5ee61d778f6baecd5a53861763763a",
    "action": "paytm:refund",
    "target": "DRY-ORDER-1789969223742",
    "submittedBy": "sandbox-agent",
    "grantedCapability": "paytm:refund",
    "createdAt": "2026-09-21T05:40:28.434Z",
    "intentHash": "13922de380518d582c6bb3e88b1d88908e71565f191119f4cadc7de4e30cf5ed",
    "signature": {
      "keyId": "default",
      "value": "UhXnkSnm5A3QU4CVrKGbP3FcTWkShnitn86psJprJpqgEBnsXWzDcZ+ktSO0FJek1X+n9DvO3SjR+WvSofS1CA==",
      "signedAt": "2026-09-21T05:40:28.555Z",
      "algorithm": "ed25519"
    }
  },
  "status": {
    "state": "FINALIZED",
    "releasedAt": "2026-09-21T05:40:32.743Z",
    "finalizedAt": "2026-09-21T05:40:32.855Z",
    "finalizationMode": "INLINE",
    "trustRecordId": "a3c8d068-af6a-46c7-9976-e43612d5ab9c"
  }
}

{
  "error": "authentication required"
}

{
  "error": "Execution Intent not found."
}

REST API guide

Execution

Transactions

Verification

Receipts

Trust Records

Replay

Policies

Policy Governance

Refusal Records

Execution Intents

Audit

System

Handbook

Get an Execution Intent and its status

Authorizations

Path Parameters

Response