v5

latestOpenAPI 3.1.0Proprietary2026-08-011476181.4 MB

Embedded Wallet Auth

Get a delegated signing key

Retrieve a delegated signing key by its system-generated id.

get/auth/delegated-keys/{id}

Path parameters

idstring required

The id of the delegated key to retrieve (the id field of the DelegatedKey returned from POST /auth/delegated-keys or GET /auth/delegated-keys).

Response

Successful operation

idstring required

Grid-issued DelegatedKey:<uuid> identifier.

cardIdstring required

The card this key is delegated for.

fundingSourceIdstring required

The card funding source this key is delegated for.

accountIdstring required

The Embedded Wallet internal account this key is delegated for, derived from the card funding source.

publicKeystring required

Compressed P-256 public key (hex) of the delegated API keypair.

nicknamestring required

Human-readable label for the delegated key.

status'PENDING' | 'ACTIVE' | 'REVOKED' required

Status of a delegated signing key.

PENDING: The delegated user exists but the policy-creation leg never completed. The key cannot sign.
ACTIVE: The policy is granted and the key may stamp quote executions.
REVOKED: The delegated user has been deleted and the key can no longer sign.

createdAtstring date-time required

When the delegated key was created.

updatedAtstring date-time required

When the delegated key was last updated.

Example response

{
  "id": "DelegatedKey:019542f5-b3e7-1d02-0000-000000000021",
  "cardId": "Card:019542f5-b3e7-1d02-0000-000000000010",
  "fundingSourceId": "CardFundingSource:019542f5-b3e7-1d02-0000-000000000011",
  "accountId": "InternalAccount:019542f5-b3e7-1d02-0000-000000000002",
  "publicKey": "02a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90",
  "nickname": "Settlement service key",
  "status": "ACTIVE",
  "spendingLimits": [
    {
      "currencyCode": "USD",
      "maxPerTransaction": 5000
    }
  ],
  "createdAt": "2026-04-08T15:30:01Z",
  "updatedAt": "2026-04-08T15:30:42Z"
}