v46

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

Get Policy

Get a policy by policy ID.

get/v1/policies/{policy_id}

Path parameters

policy_idstring required

Headers

privy-app-idstring required

ID of your Privy app.

Response

Requested policy object.

chain_type'ethereum' | 'solana' | 'cosmos' | 'stellar' | 'sui' | 'aptos' | 'movement' | 'tron' | 'bitcoin-segwit' | 'bitcoin-taproot' | 'pearl' | 'near' | 'ton' | 'starknet' | 'spark' required

The wallet chain types.

created_atnumber required

Unix timestamp of when the policy was created in milliseconds.

idstring required

Unique ID of the created policy. This will be the primary identifier when using the policy in the future.

namestring required

Name to assign to policy.

owner_idstring cuid2 required

A unique identifier for a key quorum.

version'1.0' required

Version of the policy. Currently, 1.0 is the only version.

Example response

{
  "chain_type": "ethereum",
  "created_at": 1741833088894,
  "id": "tb54eps4z44ed0jepousxi4n",
  "name": "Allowlisted stablecoins",
  "owner_id": null,
  "rules": [
    {
      "action": "ALLOW",
      "conditions": [
        {
          "field": "to",
          "field_source": "ethereum_transaction",
          "operator": "eq",
          "value": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
        }
      ],
      "id": "bdyfoa65pro1eez6iwtzanol",
      "method": "eth_sendTransaction",
      "name": "Allowlist USDC contract on Base"
    }
  ],
  "version": "1.0"
}