Coinbase-specific RPC method
Retrieves a single spend permission by its unique hash identifier. This method allows direct lookup of a specific permission without needing to know the account, chain, or spender details.
Parameters The unique hash identifier of the permission to retrieve.
Returns The permission response object. Show FetchPermissionResult properties
The permission object containing all details of the requested permission. Show Permission properties
Unix timestamp when the permission was created.
The unique hash identifier of the permission.
The cryptographic signature authorizing this permission.
The detailed spend permission parameters. Show SpendPermission properties
The address of the account granting the permission.
The address authorized to spend from the account.
The token contract address for which spending is authorized.
The maximum amount that can be spent (in smallest unit).
The duration in seconds for which the permission is valid within each period.
Unix timestamp when the permission becomes active.
Unix timestamp when the permission expires.
A unique value used to generate the permission hash.
Additional data associated with the permission (hex encoded).
{ "id" : 1 , "jsonrpc" : "2.0" , "method" : "coinbase_fetchPermission" , "params" : [{ "permissionHash" : "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef" }] } Success Response
Error Response - Permission Not Found
{ "id" : 1 , "jsonrpc" : "2.0" , "result" : { "permission" : { "createdAt" : 1640995200 , "permissionHash" : "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef" , "signature" : "0xdef456..." , "spendPermission" : { "account" : "0xfB2adc8629FC9F54e243377ffcECEb437a42934C" , "spender" : "0x2a83b0e4462449660b6e7567b2c81ac6d04d877d" , "token" : "0xA0b86a33E6441b97B7cd5C4F5B42a6e2F8a38923" , "allowance" : "1000000000000000000" , "period" : 86400 , "start" : 1640995200 , "end" : 1672531200 , "salt" : "12345678901234567890" , "extraData" : "0x" } } } }
Error Handling Code Message Description -32602 Invalid params The permissionHash parameter is invalid or missing -32603 Internal error Permission not found or internal server error -32001 Failed precondition The method is currently disabled via kill switch
The permissionHash must be a valid hex-encoded hash string. The method will return an error if the permission doesn’t exist or has been deleted.
Usage Notes This method is particularly useful when:
You have a permission hash from a previous operation and need to retrieve its details
You want to verify the current state of a specific permission
You need to look up permission details without knowing the account or spender information
Unlike coinbase_fetchPermissions, this method:
Returns a single permission instead of a list
Does not require account, chain, or spender parameters
Does not support pagination
Provides direct access via the permission’s unique identifier
