Stablecoins

Create a stablecoin burn operation

Changed on Sep 15, 2026

Create a provider-backed burn/redemption operation for a registered stablecoin. Burn sources and fiat destinations are normal Grid account objects; provider-specific Brale address ids are resolved and stored internally. External Spark wallet sources return funding instructions and remain pending until the provider reports funds received.

post/stablecoins/{stablecoinId}/burns

Request

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

Headers

Idempotency-Keystring required

Required idempotency key for retrying this burn request safely.

Request body

amountstring required

Amount to burn in the stablecoin's smallest unit. The amount must convert exactly to a whole fiat cent for the token decimals.

descriptionstring

Optional platform-provided operation description.

Example request

{
  "amount": "1000000",
  "source": {
    "type": "EXTERNAL_ACCOUNT"
  },
  "destination": {
    "type": "EXTERNAL_ACCOUNT",
    "externalAccountId": "ExternalAccount:019542f5-b3e7-1d02-0000-000000000205"
  },
  "description": "Redeem ACME"
}

Response

Burn operation created

idstring required

System-generated stablecoin issuer operation identifier.

stablecoinIdstring required

Stablecoin this operation belongs to.

operationType'MINT' | 'BURN' required

Stablecoin issuer operation type.

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

Sep 15, 20263966e5d38aad Revision changes
- breaking
  the request property type changed from object to no type
- 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
- 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
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- 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_ALREADY_EXISTS 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 DUPLICATE_EXTERNAL_ACCOUNT enum value to the response property for the response status
- warning
  added the new DUPLICATE_PAY_REQUEST enum value to the response property for the response status
- warning
  added the new INSUFFICIENT_FUNDS 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 QUOTE_EXPIRED enum value to the response property for the response status
- warning
  added the new QUOTE_RATE_UNAVAILABLE 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 SMS_OTP_CREDENTIAL_SET_CHANGED enum value to the response property for the response status
- warning
  added the new SMS_OTP_PHONE_NUMBER_ALREADY_EXISTS enum value to the response property for the response status
- warning
  added the new STABLECOIN_AMOUNT_NOT_REPRESENTABLE enum value to the response property for the response status
- warning
  added the new STABLECOIN_BURN_SOURCE_NOT_SUPPORTED enum value to the response property for the response status
- warning
  added the new STABLECOIN_EXTERNAL_ACCOUNT_LINK_FAILED enum value to the response property for the response status
- warning
  added the new STABLECOIN_EXTERNAL_ACCOUNT_LINK_METHOD_REQUIRED 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_EXTERNAL_ACCOUNT_NOT_LINKED enum value to the response property for the response status
- warning
  added the new STABLECOIN_EXTERNAL_ACCOUNT_NOT_SUPPORTED enum value to the response property for the response status
- warning
  added the new STABLECOIN_EXTERNAL_ACCOUNT_PROVIDER_LINK_FAILED enum value to the response property for the response status
- warning
  added the new STABLECOIN_EXTERNAL_ACCOUNT_PROVIDER_LINK_REQUIRED enum value to the response property for the response status
- warning
  added the new STABLECOIN_GRID_OPERATIONS_NOT_ENABLED 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_NOT_PROVISIONED 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 STABLECOIN_OPERATION_NOT_SUPPORTED enum value to the response property for the response status
- warning
  added the new STABLECOIN_PROVIDER_ERROR enum value to the response property for the response status
- warning
  added the new STABLECOIN_PROVIDER_SOURCE_NOT_LINKED enum value to the response property for the response status
- warning
  added the new STABLECOIN_SYMBOL_ALREADY_EXISTS enum value to the response property for the response status
- warning
  added the new STABLECOIN_TOKEN_IDENTIFIER_ALREADY_EXISTS enum value to the response property for the response status
- warning
  added the new STABLECOIN_VERIFICATION_FAILED 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
- warning
  added the new WALLET_NOT_PROVISIONED enum value to the response property for the response status
- info
  added discriminator to request property
- info
  added to the request property oneOf list
- 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
- 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
Sep 13, 2026ccf658daca4b Revision changes
- warning
  added the new BANK_ACCOUNT_VALIDATION_PENDING enum value to the response property for the response status

Operation history (9 revisions)