Intents

Retrieve an intent by ID. Returns its current status, authorization details, and execution result when applicable. Requests authenticated with an app secret can retrieve any intent for the app. Requests authenticated with a user token can retrieve only intents that the authenticated user created, must approve, or has signed. Unrelated intents return a 404 response.

get/v1/intents/{intent_id}

Request

  • Base URL
    https://api.privy.io
  • URL
    https://api.privy.io/v1/intents/{intent_id}
  • Auth
    HTTP basic

Path parameters

intent_idstring required

ID of the intent.

Headers

privy-app-idstring required

ID of your Privy app.

Response

Intent details.

OR
OR
OR
OR
OR
OR
OR
OR

Example response

{
  "intent_id": "clpq1234567890abcdefghij",
  "intent_type": "RPC",
  "created_by_display_name": "developer@example.com",
  "created_by_id": "did:privy:clabcd123",
  "created_at": 1741834854578,
  "resource_id": "xs76o3pi0v5syd62ui1wmijw",
  "authorization_details": [
    {
      "members": [
        {
          "type": "user",
          "user_id": "did:privy:clabcd123",
          "signed_at": null
        }
      ],
      "threshold": 1,
      "display_name": "Admin Key Quorum"
    }
  ],
  "status": "pending",
  "custom_expiry": false,
  "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
        }
      }
    }
  }
}

Changes

    • warning

      added the new earn_incentive_claim enum value to the //////// response property for the response status

    • warning

      added the new earn_incentive_claim enum value to the //////// response property for the response status

    • warning

      added the new earn_incentive_claim enum value to the ////// response property for the response status

    • warning

      added the new earn_incentive_claim enum value to the /////// response property for the response status

    • warning

      added the new earn_incentive_claim enum value to the ////// response property for the response status

    • warning

      added the new earn_incentive_claim enum value to the ////// response property for the response status

    • warning

      added the new earn_incentive_claim enum value to the //// response property for the response status

    • warning

      added the new earn_incentive_claim enum value to the ////// response property for the response status

    • warning

      added the new earn_incentive_claim enum value to the ///// response property for the response status

    • warning

      added the new earn_incentive_claim enum value to the ///// response property for the response status

    • breaking

      the ////// response property's maxLength was increased from 50 to 100 for the response status

    • breaking

      the ////// response property's maxLength was increased from 50 to 100 for the response status

    • breaking

      the //// response property's maxLength was increased from 50 to 100 for the response status

    • breaking

      the ///// response property's maxLength was increased from 50 to 100 for the response status

    • breaking

      the //// response property's maxLength was increased from 50 to 100 for the response status

    • info

      removed subschema #2 from the ///////// response property anyOf list for the response status

    • info

      removed subschema #2 from the //////// response property anyOf list for the response status

    • info

      removed subschema #2 from the //////// response property anyOf list for the response status