Stablecoins

Get a stablecoin issuer operation

Changed on

Retrieve a single stablecoin issuer operation by its Grid identifier.

get/stablecoin-operations/{stablecoinOperationId}

Request

  • Base URL: https://api.lightspark.com/grid/2025-10-13
  • URL: https://api.lightspark.com/grid/2025-10-13/stablecoin-operations/{stablecoinOperationId}
  • Auth: HTTP basic

Response

Successful operation

idstring required

System-generated stablecoin issuer operation identifier.

stablecoinIdstring 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.

amountstring 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.

stablecoinProviderAccountIdstring required

Stablecoin provider account link used for the operation.

expiresAtstring date-time

Expiry for operations awaiting external funding.

providerStatusstring

Sanitized provider status when available.

failureReasonstring

Stable internal failure code for terminal failed operations.

descriptionstring

Platform-provided operation description.

createdAtstring date-time required

Creation timestamp.

updatedAtstring date-time required

Last update timestamp.

Example response

{
  "id": "StablecoinOperation:019542f5-b3e7-1d02-0000-000000000301",
  "stablecoinId": "Stablecoin:019542f5-b3e7-1d02-0000-000000000002",
  "amount": "1000000",
  "stablecoinProviderAccountId": "StablecoinProviderAccount:019542f5-b3e7-1d02-0000-000000000001",
  "source": {
    "type": "ACH_DEBIT",
    "externalAccountId": "ExternalAccount:019542f5-b3e7-1d02-0000-000000000101",
    "accountId": "InternalAccount:019542f5-b3e7-1d02-0000-000000000102",
    "sourceTokenIdentifier": "USDC",
    "cryptoNetwork": "SOLANA"
  },
  "fundingInstructions": {
    "rail": "SPARK",
    "network": "SPARK",
    "address": "spark1...",
    "valueType": "ACME"
  },
  "destination": {
    "accountId": "ExternalAccount:019542f5-b3e7-1d02-0000-000000000205"
  },
  "estimatedDelivery": {
    "rail": "ACH_CREDIT",
    "amount": "100",
    "currency": "USD",
    "timing": "1-3 business days"
  },
  "expiresAt": "2026-05-27T16:40:00Z",
  "providerStatus": "pending",
  "failureReason": "PROVIDER_TRANSFER_FAILED",
  "description": "Initial program funding mint",
  "createdAt": "2026-05-20T16:40:00Z",
  "updatedAt": "2026-05-20T17:10:00Z"
}

Changes

  • 3966e5d38aadRevision changes
    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • warning

      added the new ACCOUNT_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new AUTH_METHOD_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new CUSTOMER_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new DOCUMENT_HOLDER_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new NOT_FOUND enum value to the response property for the response status

    • warning

      added the new PAYMENT_URL_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new PLATFORM_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new REQUEST_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new SESSION_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new STABLECOIN_EXTERNAL_ACCOUNT_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new STABLECOIN_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new STABLECOIN_OPERATION_NOT_FOUND enum value to the response property for the response status

    • warning

      added the new VERIFICATION_NOT_FOUND enum value to the response property for the response status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • b21ed434ee6eRevision changes
    • info

      endpoint added