Get intent status

GET

api

intents

{intentId}

status

Get intent status

curl --request GET \
  --url https://app.mandate.md/api/intents/{intentId}/status \
  --header 'Authorization: Bearer <token>'

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

fetch('https://app.mandate.md/api/intents/{intentId}/status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://app.mandate.md/api/intents/{intentId}/status"

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

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

print(response.text)

{
  "intentId": "9e5f1a2b-3c4d-5e6f-7a8b-9c0d1e2f3a4b",
  "status": "confirmed",
  "txHash": "0x9f2e4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f",
  "blockNumber": "12345678",
  "gasUsed": "65000",
  "amountUsd": "50.00",
  "decodedAction": "transfer(0x71c7...976f, 50000000)",
  "summary": "Transferred 50 USDC to 0x71c7...976f",
  "blockReason": null,
  "requiresApproval": false,
  "approvalId": null,
  "expiresAt": null
}

{
  "error": "<string>"
}

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

Authorizations

Authorization

string

header

required

Runtime key issued at agent registration. Prefixed with mndt_live_ (mainnet) or mndt_test_ (testnet). Pass as Authorization: Bearer mndt_test_....

Path Parameters

intentId

string<uuid>

required

The intent ID returned from validation.

Response

Intent status.

intentId

string<uuid>

required

status

enum<string>

required

Current intent state.

Available options:

allowed,

reserved,

approval_pending,

approved,

rejected,

broadcasted,

confirmed,

failed,

expired

txHash

string | null

On-chain transaction hash, if broadcasted.

blockNumber

string | null

Block number where the transaction was confirmed.

gasUsed

string | null

Gas consumed by the transaction.

amountUsd

string | null

USD value of the transaction.

decodedAction

string | null

Decoded function call (e.g. "transfer(0x71c7...976f, 50000000)").

summary

string | null

Human-readable summary of the transaction.

blockReason

string | null

Block reason if the intent failed due to policy.

requiresApproval

boolean

True if the intent is currently awaiting human approval.

approvalId

string<uuid> | null

Approval queue entry ID, if applicable.

expiresAt

string<date-time> | null

When the intent expires if not acted upon.

Check address riskRun a risk assessment against a target address using the Aegis security scanner. Returns a risk level and warnings.

Get intent status

curl --request GET \
  --url https://app.mandate.md/api/intents/{intentId}/status \
  --header 'Authorization: Bearer <token>'

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

fetch('https://app.mandate.md/api/intents/{intentId}/status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://app.mandate.md/api/intents/{intentId}/status"

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

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

print(response.text)

{
  "intentId": "9e5f1a2b-3c4d-5e6f-7a8b-9c0d1e2f3a4b",
  "status": "confirmed",
  "txHash": "0x9f2e4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f",
  "blockNumber": "12345678",
  "gasUsed": "65000",
  "amountUsd": "50.00",
  "decodedAction": "transfer(0x71c7...976f, 50000000)",
  "summary": "Transferred 50 USDC to 0x71c7...976f",
  "blockReason": null,
  "requiresApproval": false,
  "approvalId": null,
  "expiresAt": null
}

{
  "error": "<string>"
}

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

API Reference

Agent API

Dashboard API

Get intent status

Authorizations

Path Parameters

Response