Issuance

List issuance transactions

Lists issuance transactions across tokens for the current organization or project. Selected-wallet API keys are scoped to their token-readable wallet bindings when walletId is omitted. Use repeated type query parameters, for example type=burn&type=force_burn, to request multiple transaction types.

get/v1/issuance/transactions

Query parameters

walletIdstring

Filter to transactions associated with a wallet. Selected-wallet API keys must have wallet-level tokens:read for the requested wallet.

Example:privy_wallet_123

Filter to transactions associated with a wallet. Selected-wallet API keys must have wallet-level tokens:read for the requested wallet.

typestring[]

Filter by transaction type. Repeat this query parameter for multiple values, for example type=burn&type=force_burn.

[
  "burn",
  "force_burn"
]

status'pending' | 'processing' | 'confirmed' | 'finalized' | 'failed'

Filter by token transaction status.

Example:confirmed

Filter by token transaction status.

pageinteger

Page number (1-based).

Example:1

Page number (1-based).

pageSizeinteger

Number of items per page.

Example:50

Number of items per page.

Headers

x-project-idstring

Selects the active project for this request. Required for session/dashboard callers. Ignored when authenticating with an API key, whose scope is fixed to the key's project.

Example:prj_example

Selects the active project for this request. Required for session/dashboard callers. Ignored when authenticating with an API key, whose scope is fixed to the key's project.

Response

Issuance transaction list

Example response

{
  "data": [
    {
      "token": {
        "id": "tok_example",
        "name": "Example Token",
        "symbol": "EXM"
      },
      "transaction": {
        "id": "ttx_example",
        "tokenId": "tok_example",
        "organizationId": "org_example",
        "type": "mint",
        "status": "confirmed",
        "signature": "sig_example",
        "idempotencyKey": "idem_example_12345",
        "idempotencyFingerprint": "4f2d9c7a5e6f1c...",
        "serializedTx": "AQID",
        "slot": 123456,
        "blockTime": "2025-01-01T00:00:00.000Z",
        "fee": 5000,
        "error": "Signature failed",
        "initiatedByKeyId": "key_example",
        "createdAt": "2025-01-01T00:00:00.000Z",
        "updatedAt": "2025-01-02T00:00:00.000Z"
      }
    }
  ],
  "meta": {
    "requestId": "req_example"
  }
}

Changes

Changed in 1 of the 9 revisions of this API.5

Aug 15, 20263e302bba53865See the full diff
- ●
  added the new SERVICE_UNAVAILABLE enum value to the error/code response property for the response status 400
  response-property-enum-value-added
- ●
  added the new SERVICE_UNAVAILABLE enum value to the error/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new SERVICE_UNAVAILABLE enum value to the error/code response property for the response status 403
  response-property-enum-value-added
- ●
  added the new SERVICE_UNAVAILABLE enum value to the error/code response property for the response status 404
  response-property-enum-value-added
- ●
  added the new SERVICE_UNAVAILABLE enum value to the error/code response property for the response status 500
  response-property-enum-value-added

Full history