---
title: "List stablecoin issuer operations"
method: GET
path: "/stablecoins/{stablecoinId}/operations"
tags: ["Stablecoins"]
---

# List stablecoin issuer operations

`GET /stablecoins/{stablecoinId}/operations`

## Request

- Base URL: `https://api.lightspark.com/grid/2025-10-13`
- URL: `https://api.lightspark.com/grid/2025-10-13/stablecoins/{stablecoinId}/operations`
- Auth: HTTP basic

List issuer mint and burn operations for a stablecoin, most recent first, with cursor pagination.

## Query parameters

- `operationType` 'MINT' | 'BURN': Stablecoin issuer operation type.
- `limit` integer
- `cursor` string

## Response `200`

Successful operation

- StablecoinOperationListResponse
  - `data` StablecoinOperation[], required
    - `id` string, required: System-generated stablecoin issuer operation identifier.
    - `stablecoinId` string, required: Stablecoin this operation belongs to.
    - `operationType` 'MINT' | 'BURN', required: Stablecoin issuer operation type.
    - `status` 'CREATED' | 'PENDING_FUNDING' | 'PENDING_PROVIDER' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'EXPIRED', required: Stablecoin issuer operation lifecycle status.
    - `amount` string, required: Operation amount in the stablecoin's smallest unit.
    - `provider` 'BRALE', required: Stablecoin provider backing the linked account, stablecoin, or operation.
    - `providerEnvironment` 'SANDBOX' | 'PRODUCTION', required: Provider environment derived from the authenticated Grid platform mode.
    - `stablecoinProviderAccountId` string, required: Stablecoin provider account link used for the operation.
    - `source` StablecoinOperationSource: Source of a stablecoin operation, as reported on a `StablecoinOperation`. A single merged shape (superset of the mint funding source and burn source request variants) so the field is unambiguously deserializable regardless of operation type: `externalAccountId` is present for external-account funded mints, `accountId` for Grid internal account sources, and `sourceTokenIdentifier`/`cryptoNetwork` for provider internal balance sources.
      - `type` 'WIRE' | 'ACH_DEBIT' | 'SAME_DAY_ACH_DEBIT' | 'EXTERNAL_ACCOUNT' | 'GRID_INTERNAL_ACCOUNT' | 'PROVIDER_INTERNAL_BALANCE', required: Source variant. Mint funding uses `WIRE`, `ACH_DEBIT`, or `SAME_DAY_ACH_DEBIT`; burns use `EXTERNAL_ACCOUNT`. `GRID_INTERNAL_ACCOUNT` and `PROVIDER_INTERNAL_BALANCE` are shared across mint and burn.
      - `externalAccountId` string: Grid `ExternalAccount` funding the operation, present for ACH debit mints.
      - `accountId` string: Grid internal account id, present for Grid internal account sources.
      - `sourceTokenIdentifier` string: Provider token/value type, present for provider internal balance sources.
      - `cryptoNetwork` string: Source crypto network, present for provider internal balance sources.
    - `fundingInstructions` StablecoinFundingInstructions: Provider funding instructions safe to show publicly. Present for wire-funded mint operations and external-source burn operations when available. The common fields below are always declared; the exact set of remaining fields is rail- and provider-specific (for example, wire instructions carry bank beneficiary/account/routing details while Spark and on-chain instructions carry a deposit address), so `additionalProperties` stays open to pass those through without a spec change per rail.
      - `rail` string: Funding rail these instructions apply to (e.g. `SPARK`, `WIRE`).
      - `network` string: Network the funds should be sent on, when applicable.
      - `address` string: Deposit address the issuer sends funds to, for on-chain or Spark rails.
      - `valueType` string: Provider token/value type the deposit address expects.
    - `destination` StablecoinOperationDestination: Destination of a stablecoin operation, as reported on a `StablecoinOperation`. A single merged (flat) shape so the field is unambiguously deserializable regardless of operation type: `accountId` identifies the receiving account (its `ExternalAccount:` / `InternalAccount:` prefix disambiguates external vs Grid-managed), and `rail` is present for burn (fiat payout) destinations and absent for mint destinations.
      - `accountId` string, required: Grid account that received the funds. An `ExternalAccount:` id for external destinations or an `InternalAccount:` id for Grid-managed destinations.
      - `rail` 'WIRE' | 'ACH_CREDIT' | 'SAME_DAY_ACH_CREDIT' | 'RTP_CREDIT': Fiat payout rail, present for burn (fiat redemption) destinations.
    - `estimatedDelivery` StablecoinEstimatedDelivery: Static rail timing estimate for fiat redemption delivery. This is guidance, not a guaranteed arrival time.
      - `rail` string: Fiat payout rail the estimate applies to.
      - `amount` string: Estimated delivery amount in the smallest unit of `currency` (e.g. cents for USD).
      - `currency` string: ISO 4217 currency code of the fiat payout.
      - `timing` string: Human-readable rail timing estimate.
    - `expiresAt` string, date-time: Expiry for operations awaiting external funding.
    - `providerStatus` string: Sanitized provider status when available.
    - `failureReason` string: Stable internal failure code for terminal failed operations.
    - `description` string: Platform-provided operation description.
    - `createdAt` string, date-time, required: Creation timestamp.
    - `updatedAt` string, date-time, required: Last update timestamp.
  - `hasMore` boolean, required: Indicates if more results are available beyond this page.
  - `nextCursor` string: Cursor to retrieve the next page of results.
  - `totalCount` integer: Total number of stablecoin operations matching the query.

## Other responses

- `401`: Unauthorized
- `404`: Stablecoin not found
- `500`: Internal service error

## Changes

> 115 revisions in range; 2 not diffed.

- **2026-10-02** `dfe5a02f2fee`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lightsparkdev/apis/grid-api/changes/stablecoins/:stablecoinId/operations/get.md)

---

[API](https://skmtc.dev/lightsparkdev/apis/grid-api.md) - [All operations](https://skmtc.dev/lightsparkdev/apis/grid-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lightsparkdev/apis/grid-api/revisions/7a1db46ec552?raw)