Skip to main content
Your app can fetch an intent from the Privy API to check its current status, view approval progress, and retrieve execution results.

​
Usage

To fetch an intent, make a GET request to:
GET https://api.privy.io/v1/intents/{intent_id}

curl https://api.privy.io/v1/intents/{intent_id} \
  -H "Authorization: Basic <encoded-credentials>" \
  -H "privy-app-id: <your-app-id>"

​
Response fields

​
intent_id
string
Unique identifier for the intent.
​
intent_type
'RPC' | 'WALLET' | 'POLICY' | 'RULE' | 'KEY_QUORUM'
The type of action the intent proposes.
​
created_by_display_name
string | null
Email address of the team member who proposed the intent. May be null for intents proposed via the API.
​
created_by_id
string
The Privy DID of the team member who proposed the intent.
​
created_at
number
UNIX timestamp (ms) for when the intent was created.
​
resource_id
string
ID of the resource the intent targets (e.g., a wallet ID or policy ID).
​
authorization_details
array
List of key quorums assigned to the intent.
​
status
'pending' | 'granted' | 'executed' | 'rejected' | 'expired' | 'dismissed'
Current status of the intent. See intent lifecycle for details on each status.
​
expires_at
number
UNIX timestamp (ms) for when the intent expires.
​
request_details
object
The full request for the proposed action, including HTTP method, URL, and body.
​
action_result
object | null
Response body from execution, if the intent has completed. For transaction intents, this contains the transaction hash.
For transaction intents, your app can read the transaction hash from action_result to track the transaction on-chain.

​
API reference

Get intent

View the full API reference for fetching an intent.