Create a stablecoin mint operation
Create a provider-backed mint operation for a registered stablecoin. Funding and destination accounts are normal Grid ExternalAccount objects; any provider-specific Brale address linkage is managed internally by Grid. Wire-funded mints return funding instructions and remain pending until the provider reports funds received.
Authorizations
API token authentication using format <api token id>:<api client secret>
Headers
Required idempotency key for retrying this mint request safely.
255Path Parameters
System-generated stablecoin identifier
Body
Amount to mint in the stablecoin's smallest unit. The amount must convert exactly to a whole fiat cent for the token decimals.
^[0-9]+$"1000000"
Wire funding source. The issuer wires fiat to the provider using the returned funding instructions.
- Wire
- ACH Debit
- Same-Day ACH Debit
- Grid Internal Account
- Provider Internal Balance
Account that receives the minted stablecoin. External and Grid-managed accounts are represented as a single account reference, matching the accountId pattern used elsewhere in the API; the id prefix (ExternalAccount: or InternalAccount:) determines which. In the initial Brale-backed flow this must reference an active Spark external account.
Optional platform-provided operation description.
1024"Initial program funding mint"
Response
Mint operation created
System-generated stablecoin issuer operation identifier.
"StablecoinOperation:019542f5-b3e7-1d02-0000-000000000301"
Stablecoin this operation belongs to.
"Stablecoin:019542f5-b3e7-1d02-0000-000000000002"
Stablecoin issuer operation type.
MINT, BURN Stablecoin issuer operation lifecycle status.
CREATED, PENDING_FUNDING, PENDING_PROVIDER, PROCESSING, COMPLETED, FAILED, EXPIRED Operation amount in the stablecoin's smallest unit.
"1000000"
Stablecoin provider backing the linked account, stablecoin, or operation.
BRALE Provider environment derived from the authenticated Grid platform mode.
SANDBOX, PRODUCTION Stablecoin provider account link used for the operation.
"StablecoinProviderAccount:019542f5-b3e7-1d02-0000-000000000001"
Creation timestamp.
"2026-05-20T16:40:00Z"
Last update timestamp.
"2026-05-20T17:10:00Z"
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 and external-account burns, accountId for Grid internal account sources, and sourceTokenIdentifier/cryptoNetwork for provider internal balance sources.
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.
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.
Static rail timing estimate for fiat redemption delivery. This is guidance, not a guaranteed arrival time.
Expiry for operations awaiting external funding.
"2026-05-27T16:40:00Z"
Sanitized provider status when available.
"pending"
Stable internal failure code for terminal failed operations.
"PROVIDER_TRANSFER_FAILED"
Platform-provided operation description.
"Initial program funding mint"