v46

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-211591,0051.4 MB
Intents

List intents

List intents for an app. Returns a paginated list of intents with their current status and details.

get/v1/intents

Query parameters

cursorstring
limitnumber nullable
status'pending' | 'processing' | 'executed' | 'failed' | 'expired' | 'rejected' | 'dismissed'

Current status of an intent.

intent_type'KEY_QUORUM' | 'POLICY' | 'RULE' | 'RPC' | 'TRANSFER' | 'WALLET'

Type of intent.

created_by_idstring
pending_member_idstring
resource_idstring
current_user_has_signed'true' | 'false'
sort_by'created_at_desc' | 'expires_at_asc' | 'updated_at_desc'

Headers

privy-app-idstring required

ID of your Privy app.

Response

List of intents.

next_cursorstring nullable

Example response

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