Skip to main content
GET
/
v2
/
embedded-wallet-api
/
end-users
/
{userId}
/
address
/
{address}
/
delegation
Get account-scoped delegation for end user
curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/embedded-wallet-api/end-users/{userId}/address/{address}/delegation \
  --header 'Authorization: Bearer <token>'
{
  "expiresAt": "2026-02-03T10:35:00Z"
}

Authorizations

​
Authorization
string
header
required

A JWT signed using the developer's own JWT private key (in the case of JWT authentication), or an end user JWT signed by CDP, encoded in base64. This is used for End User Account APIs.

Path Parameters

​
userId
string
required

The ID of the end user.

Pattern: ^[a-zA-Z0-9-]{1,100}$
Example:

"e051beeb-7163-4527-a5b6-35e301529ff2"

​
address
string
required

The blockchain address of the end user account to query. For EVM addresses, matching is case-insensitive. A blockchain address. Format varies by network (e.g., 0x-prefixed for EVM, base58 for Solana).

Required string length: 1 - 128
Example:

"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"

Query Parameters

​
projectID
string

The ID of the CDP Project. Required for end users authenticated using custom auth (i.e. a non-CDP JWT provider).

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
Example:

"8e03978e-40d5-43e8-bc93-6894a57f9324"

Response

Active delegation found.

​
expiresAt
string<date-time>
required

The date until which the delegation is valid.

Example:

"2026-02-03T10:35:00Z"