Get delegation for end user

Returns the active delegation for the specified end user, if one exists. This operation can be performed by the end user themselves or by a developer using their API key.

GET /v2/embedded-wallet-api/end-users/{userId}/delegation

Get delegation for end user

cURL

curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/embedded-wallet-api/end-users/{userId}/delegation \
  --header 'Authorization: Bearer <token>'

200

{
  "expiresAt": "2026-02-03T10:35:00Z"
}

Authorizations

endUserAuthapiKeyAuth

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"

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

200

application/json

Active delegation found.

expiresAt · string<date-time> · required

The date until which the delegation is valid.

Example:

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