Create a stablecoin burn operation

curl --request POST \
  --url https://api.lightspark.com/grid/2025-10-13/stablecoins/{stablecoinId}/burns \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "amount": "1000000",
  "source": {
    "type": "EXTERNAL_ACCOUNT"
  },
  "destination": {
    "type": "EXTERNAL_ACCOUNT",
    "externalAccountId": "ExternalAccount:019542f5-b3e7-1d02-0000-000000000205"
  },
  "description": "Redeem ACME"
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Basic <encoded-value>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: '1000000',
    source: {type: 'EXTERNAL_ACCOUNT'},
    destination: {
      type: 'EXTERNAL_ACCOUNT',
      externalAccountId: 'ExternalAccount:019542f5-b3e7-1d02-0000-000000000205'
    },
    description: 'Redeem ACME'
  })
};

fetch('https://api.lightspark.com/grid/2025-10-13/stablecoins/{stablecoinId}/burns', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

val client = OkHttpClient()

val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{\n  \"amount\": \"1000000\",\n  \"source\": {\n    \"type\": \"EXTERNAL_ACCOUNT\"\n  },\n  \"destination\": {\n    \"type\": \"EXTERNAL_ACCOUNT\",\n    \"externalAccountId\": \"ExternalAccount:019542f5-b3e7-1d02-0000-000000000205\"\n  },\n  \"description\": \"Redeem ACME\"\n}")
val request = Request.Builder()
  .url("https://api.lightspark.com/grid/2025-10-13/stablecoins/{stablecoinId}/burns")
  .post(body)
  .addHeader("Idempotency-Key", "<idempotency-key>")
  .addHeader("Authorization", "Basic <encoded-value>")
  .addHeader("Content-Type", "application/json")
  .build()

val response = client.newCall(request).execute()

{
  "id": "StablecoinOperation:019542f5-b3e7-1d02-0000-000000000301",
  "stablecoinId": "Stablecoin:019542f5-b3e7-1d02-0000-000000000002",
  "operationType": "MINT",
  "status": "CREATED",
  "amount": "1000000",
  "provider": "BRALE",
  "providerEnvironment": "SANDBOX",
  "stablecoinProviderAccountId": "StablecoinProviderAccount:019542f5-b3e7-1d02-0000-000000000001",
  "createdAt": "2026-05-20T16:40:00Z",
  "updatedAt": "2026-05-20T17:10:00Z",
  "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",
    "rail": "WIRE"
  },
  "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"
}

{
  "code": "INVALID_INPUT",
  "reason": "<string>",
  "details": {
    "errors": [
      {
        "field": "identifier",
        "constraint": {
          "format": "email",
          "pattern": "^\\d{5}(-\\d{4})?$",
          "enum": [
            "SSN",
            "ITIN",
            "NON_US_TAX_ID"
          ],
          "minLength": 1,
          "maxLength": 500
        },
        "message": "Value is not one of the allowed enum members."
      }
    ],
    "missingRequirements": [
      "SUPPORTING_PROOF"
    ],
    "refusalReason": "AGENT_POLICY_DENIED",
    "missingFields": [
      "PHONE_NUMBER"
    ]
  }
}

{
  "code": "UNAUTHORIZED",
  "reason": "<string>",
  "details": {}
}

{
  "code": "TRANSACTION_NOT_FOUND",
  "reason": "<string>",
  "details": {}
}

{
  "code": "TRANSACTION_NOT_PENDING_PLATFORM_APPROVAL",
  "reason": "<string>",
  "details": {}
}

{
  "code": "GRID_SWITCH_ERROR",
  "reason": "<string>",
  "details": {}
}

{
  "code": "SERVICE_UNAVAILABLE",
  "reason": "<string>",
  "details": {}
}

POST

stablecoins

{stablecoinId}

burns

Create a stablecoin burn operation

curl --request POST \
  --url https://api.lightspark.com/grid/2025-10-13/stablecoins/{stablecoinId}/burns \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "amount": "1000000",
  "source": {
    "type": "EXTERNAL_ACCOUNT"
  },
  "destination": {
    "type": "EXTERNAL_ACCOUNT",
    "externalAccountId": "ExternalAccount:019542f5-b3e7-1d02-0000-000000000205"
  },
  "description": "Redeem ACME"
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Basic <encoded-value>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: '1000000',
    source: {type: 'EXTERNAL_ACCOUNT'},
    destination: {
      type: 'EXTERNAL_ACCOUNT',
      externalAccountId: 'ExternalAccount:019542f5-b3e7-1d02-0000-000000000205'
    },
    description: 'Redeem ACME'
  })
};

fetch('https://api.lightspark.com/grid/2025-10-13/stablecoins/{stablecoinId}/burns', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

val client = OkHttpClient()

val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{\n  \"amount\": \"1000000\",\n  \"source\": {\n    \"type\": \"EXTERNAL_ACCOUNT\"\n  },\n  \"destination\": {\n    \"type\": \"EXTERNAL_ACCOUNT\",\n    \"externalAccountId\": \"ExternalAccount:019542f5-b3e7-1d02-0000-000000000205\"\n  },\n  \"description\": \"Redeem ACME\"\n}")
val request = Request.Builder()
  .url("https://api.lightspark.com/grid/2025-10-13/stablecoins/{stablecoinId}/burns")
  .post(body)
  .addHeader("Idempotency-Key", "<idempotency-key>")
  .addHeader("Authorization", "Basic <encoded-value>")
  .addHeader("Content-Type", "application/json")
  .build()

val response = client.newCall(request).execute()

{
  "id": "StablecoinOperation:019542f5-b3e7-1d02-0000-000000000301",
  "stablecoinId": "Stablecoin:019542f5-b3e7-1d02-0000-000000000002",
  "operationType": "MINT",
  "status": "CREATED",
  "amount": "1000000",
  "provider": "BRALE",
  "providerEnvironment": "SANDBOX",
  "stablecoinProviderAccountId": "StablecoinProviderAccount:019542f5-b3e7-1d02-0000-000000000001",
  "createdAt": "2026-05-20T16:40:00Z",
  "updatedAt": "2026-05-20T17:10:00Z",
  "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",
    "rail": "WIRE"
  },
  "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"
}

{
  "code": "INVALID_INPUT",
  "reason": "<string>",
  "details": {
    "errors": [
      {
        "field": "identifier",
        "constraint": {
          "format": "email",
          "pattern": "^\\d{5}(-\\d{4})?$",
          "enum": [
            "SSN",
            "ITIN",
            "NON_US_TAX_ID"
          ],
          "minLength": 1,
          "maxLength": 500
        },
        "message": "Value is not one of the allowed enum members."
      }
    ],
    "missingRequirements": [
      "SUPPORTING_PROOF"
    ],
    "refusalReason": "AGENT_POLICY_DENIED",
    "missingFields": [
      "PHONE_NUMBER"
    ]
  }
}

{
  "code": "UNAUTHORIZED",
  "reason": "<string>",
  "details": {}
}

{
  "code": "TRANSACTION_NOT_FOUND",
  "reason": "<string>",
  "details": {}
}

{
  "code": "TRANSACTION_NOT_PENDING_PLATFORM_APPROVAL",
  "reason": "<string>",
  "details": {}
}

{
  "code": "GRID_SWITCH_ERROR",
  "reason": "<string>",
  "details": {}
}

{
  "code": "SERVICE_UNAVAILABLE",
  "reason": "<string>",
  "details": {}
}

Authorizations

Authorization

string

header

required

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

Headers

Idempotency-Key

string

required

Required idempotency key for retrying this burn request safely.

Maximum string length: 255

Path Parameters

stablecoinId

string

required

System-generated stablecoin identifier

Body

application/json

amount

string

required

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

Pattern: ^[0-9]+$

Example:

"1000000"

source

External Account · object

required

External account burn source. The issuer sends the stablecoin to the provider deposit address returned in the operation's funding instructions; it may be sent from any wallet.

External Account
Grid Internal Account
Provider Internal Balance

Show child attributes

destination

External Account · object

required

External Account
Grid Internal Account

Show child attributes

description

string

Optional platform-provided operation description.

Maximum string length: 1024

Example:

"Redeem ACME"

Response

Burn operation created

string

required

System-generated stablecoin issuer operation identifier.

Example:

"StablecoinOperation:019542f5-b3e7-1d02-0000-000000000301"

stablecoinId

string

required

Stablecoin this operation belongs to.

Example:

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

operationType

enum<string>

required

Stablecoin issuer operation type.

Available options:

MINT,

BURN

status

enum<string>

required

Stablecoin issuer operation lifecycle status.

Available options:

CREATED,

PENDING_FUNDING,

PENDING_PROVIDER,

PROCESSING,

COMPLETED,

FAILED,

EXPIRED

amount

string

required

Operation amount in the stablecoin's smallest unit.

Example:

"1000000"

provider

enum<string>

required

Stablecoin provider backing the linked account, stablecoin, or operation.

Available options:

BRALE

providerEnvironment

enum<string>

required

Provider environment derived from the authenticated Grid platform mode.

Available options:

SANDBOX,

PRODUCTION

stablecoinProviderAccountId

string

required

Stablecoin provider account link used for the operation.

Example:

"StablecoinProviderAccount:019542f5-b3e7-1d02-0000-000000000001"

createdAt

string<date-time>

required

Creation timestamp.

Example:

"2026-05-20T16:40:00Z"

updatedAt

string<date-time>

required

Last update timestamp.

Example:

"2026-05-20T17:10:00Z"

source

object

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.

Show child attributes

fundingInstructions

object

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.

Show child attributes

Example:

{
  "rail": "SPARK",
  "network": "SPARK",
  "address": "spark1...",
  "valueType": "ACME"
}

destination

object

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.

Show child attributes

estimatedDelivery

object

Static rail timing estimate for fiat redemption delivery. This is guidance, not a guaranteed arrival time.

Show child attributes

Example:

{
  "rail": "ACH_CREDIT",
  "amount": "100",
  "currency": "USD",
  "timing": "1-3 business days"
}

expiresAt

string<date-time>

Expiry for operations awaiting external funding.

Example:

"2026-05-27T16:40:00Z"

providerStatus

string

Sanitized provider status when available.

Example:

"pending"

failureReason

string

Stable internal failure code for terminal failed operations.

Example:

"PROVIDER_TRANSFER_FAILED"

description

string

Platform-provided operation description.

Example:

"Initial program funding mint"

Using the API

API documentation

Create a stablecoin burn operation

Authorizations

Headers

Path Parameters

Body

Response