LIlightsparkdev
Embedded Wallet Auth

Get a delegated signing key

Changed on

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

get/auth/delegated-keys/{id}

Request

  • Base URL
    https://api.lightspark.com/grid/2025-10-13
  • URL
    https://api.lightspark.com/grid/2025-10-13/auth/delegated-keys/{id}
  • Auth
    HTTP basic

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

The card this key is delegated for. Present only for card keys.

fundingSourceIdstring

The card funding source this key is delegated for. Present only for card keys.

agentIdstring

The agent this key is delegated for. Present only for agent keys.

accountIdstring required

The Embedded Wallet internal account this key is delegated for, derived from the card funding source or the agent's customer.

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",
  "agentId": "Agent:019542f5-b3e7-1d02-0000-000000000042",
  "accountId": "InternalAccount:019542f5-b3e7-1d02-0000-000000000002",
  "publicKey": "02a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90",
  "nickname": "Settlement service key",
  "status": "ACTIVE",
  "createdAt": "2026-04-08T15:30:01Z",
  "updatedAt": "2026-04-08T15:30:42Z"
}

Changes