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>"

{
  "intent_id": "clpq1234567890abcdefghij",
  "intent_type": "RPC",
  "created_by_display_name": "[email protected]",
  "created_by_id": "did:privy:clabcd123",
  "created_at": 1741834854578,
  "resource_id": "xs76o3pi0v5syd62ui1wmijw",
  "authorization_details": [
    {
      "members": [
        {
          "type": "user",
          "user_id": "did:privy:clabcd123",
          "display_name": "[email protected]",
          "signed_at": null
        }
      ],
      "threshold": 1,
      "display_name": "Admin Key Quorum"
    }
  ],
  "status": "pending",
  "expires_at": 1741921254578,
  "request_details": {
    "method": "POST",
    "url": "https://api.privy.io/v1/wallets/xs76o3pi0v5syd62ui1wmijw/rpc",
    "body": {
      "method": "eth_sendTransaction",
      "caip2": "eip155:8453",
      "chain_type": "ethereum",
      "params": {
        "transaction": {
          "to": "0x0000000000000000000000000000000000000000",
          "value": 1
        }
      }
    }
  }
}

​
Response fields

​
intent_id
string
Unique identifier for the intent.
​
intent_type
'RPC' | 'TRANSFER' | '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' | 'processing' | '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.