Skip to main content
GET
/
api
/
intents
/
{intentId}
/
status
Get intent status
curl --request GET \
  --url https://app.mandate.md/api/intents/{intentId}/status \
  --header 'Authorization: Bearer <token>'
{
  "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
}

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.