Skip to main content
GET
Get a delegated signing key

Authorizations

Authorization
string
header
required

API token authentication using format <api token id>:<api client secret>

Path Parameters

id
string
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

A delegated signing key for either a card funding source or an agent. Card keys include cardId and fundingSourceId; agent keys include agentId. Returned from POST /auth/delegated-keys (on activation), GET /auth/delegated-keys (list), and GET /auth/delegated-keys/{id}. accountId says where the signing material comes from. For a key on an Embedded Wallet internal account, Grid generates and custodies the keypair and never returns the private key; publicKey identifies it. While ACTIVE, Grid may use it to authorize Spark token-transaction signing for the selected card funding source or agent in place of a session keypair. A key on a crypto external account that carries providerWallet is a provider wallet key. Grid creates it when the cardholder has delegated the wallet at the provider and the card is funded by that wallet, and while ACTIVE uses the delegated share to sign the card's transfers.

id
string
required

Grid-issued DelegatedKey:<uuid> identifier.

Example:

"DelegatedKey:019542f5-b3e7-1d02-0000-000000000021"

accountId
string
required

The account this key is delegated for, derived from the card funding source or the agent's customer. An Embedded Wallet internal account for a key Grid generated, or a crypto external account that carries providerWallet for a provider wallet key.

Example:

"InternalAccount:019542f5-b3e7-1d02-0000-000000000002"

nickname
string
required

Human-readable label for the delegated key.

Example:

"Settlement service key"

status
enum<string>
required

Status of a delegated signing key.

  • PENDING: The policy-creation leg never completed, so the key cannot sign yet. Only keys for an Embedded Wallet internal account are ever PENDING.
  • ACTIVE: Grid holds material that can sign for the card funding source or agent.
  • REVOKED: The key was revoked through Grid, or the delegation was revoked at the provider. It can no longer sign, and this is terminal.
Available options:
PENDING,
ACTIVE,
REVOKED
Example:

"ACTIVE"

createdAt
string<date-time>
required

When the delegated key was created.

Example:

"2026-04-08T15:30:01Z"

updatedAt
string<date-time>
required

When the delegated key was last updated.

Example:

"2026-04-08T15:30:42Z"

cardId
string

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

Example:

"Card:019542f5-b3e7-1d02-0000-000000000010"

fundingSourceId
string

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

Example:

"CardFundingSource:019542f5-b3e7-1d02-0000-000000000011"

agentId
string

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

Example:

"Agent:019542f5-b3e7-1d02-0000-000000000042"

publicKey
string

Compressed P-256 public key (hex) of the delegated API keypair. It equals the key in the payload the wallet owner stamped on the first leg. Present only on keys for an Embedded Wallet internal account.

Example:

"02a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90"