# Seismic Card Issuance API

> Issue and manage virtual cards via the Seismic API — authenticate, run KYC, and issue cards on your hostname.

## Docs

- [Introduction](https://apidocs.seismic-cards.systems/index.md): One white-labeled API to issue and manage cards on Seismic.
- [Quickstart](https://apidocs.seismic-cards.systems/quickstart.md): Go from an API key to a live card in five steps.
- [Authentication](https://apidocs.seismic-cards.systems/authentication.md): Seismic API keys, bearer tokens, and roles.
- [Applicants & KYC](https://apidocs.seismic-cards.systems/concepts/applicants.md): Onboard end-users and verify their identity.
- [Identity verification (KYC)](https://apidocs.seismic-cards.systems/guides/kyc-integration.md): How tenant KYC and issuer KYC work, and how to integrate hosted or bring-your-own verification.
- [Programs & Accounts](https://apidocs.seismic-cards.systems/concepts/programs-accounts.md): Define card products and the funding that backs them.
- [Card funding (wallet & BYO)](https://apidocs.seismic-cards.systems/guides/card-funding.md): Fund prepaid cards with stablecoins using Seismic wallet service or a bring-your-own (BYO) external wallet.
- [Cards](https://apidocs.seismic-cards.systems/concepts/cards.md): Issue, manage, and securely reveal cards.
- [Viewing card details (PAN / CVV)](https://apidocs.seismic-cards.systems/guides/viewing-card-details.md): Two ways to show full card numbers — Widget.js (default) or encrypted server-side reveal for PCI DSS Level 1.
- [Response format](https://apidocs.seismic-cards.systems/guides/responses.md): The envelopes every endpoint returns.
- [Webhooks](https://apidocs.seismic-cards.systems/guides/webhooks.md): Inbound provider callbacks and outbound Seismic events.
- [Error codes](https://apidocs.seismic-cards.systems/guides/errors.md): Stable, machine-readable error codes and their HTTP status.
- [Get an access token](https://apidocs.seismic-cards.systems/api-reference/authentication/get-an-access-token.md): Exchange a Seismic API key (`client_id` + `client_secret`) for a short-lived bearer access token. This is the only credential your services ever need — Seismic manages every upstream provider on your behalf. **No `Authorization` header is required** — this endpoint issues the token; it does not cons…
- [KYC integration settings](https://apidocs.seismic-cards.systems/api-reference/kyc/kyc-integration-settings.md): Returns whether hosted verification and BYOK share tokens are available, plus the share recipient id for generating identity share tokens.
- [List applicants](https://apidocs.seismic-cards.systems/api-reference/applicants/list-applicants.md)
- [Create an applicant](https://apidocs.seismic-cards.systems/api-reference/applicants/create-an-applicant.md)
- [Get an applicant](https://apidocs.seismic-cards.systems/api-reference/applicants/get-an-applicant.md)
- [Submit for KYC](https://apidocs.seismic-cards.systems/api-reference/applicants/submit-for-kyc.md): Polls tenant identity verification status. When approved, provisions the issuer sub-account, forwards verification to the card program (share token + initialize), and returns updated issuer KYC fields.
- [Start a hosted KYC session](https://apidocs.seismic-cards.systems/api-reference/applicants/start-a-hosted-kyc-session.md): Returns a short-lived access token for the hosted identity-verification widget.
- [Share BYOK verification with the issuer](https://apidocs.seismic-cards.systems/api-reference/applicants/share-byok-verification-with-the-issuer.md): For integrators with their own identity provider: after verifying an end-user, generate a short-lived share token (recipient from GET /v1/kyc/config) and submit it here. Seismic registers identity with the card program. Include status APPROVED to attest verification in the same request.
- [Refresh issuer KYC status](https://apidocs.seismic-cards.systems/api-reference/applicants/refresh-issuer-kyc-status.md): Polls the issuer for the latest identity verification status. Does not submit share tokens or trigger handoff — use POST /v1/applicants/{id}/submit or POST /v1/applicants/{id}/kyc-share for that.
- [List accounts](https://apidocs.seismic-cards.systems/api-reference/accounts/list-accounts.md)
- [Create an account](https://apidocs.seismic-cards.systems/api-reference/accounts/create-an-account.md): Creates a funding account for a program. Required before card issuance — pass the returned id as account_id in POST /v1/cards.
- [Get an account](https://apidocs.seismic-cards.systems/api-reference/accounts/get-an-account.md)
- [Get account balance](https://apidocs.seismic-cards.systems/api-reference/accounts/get-account-balance.md)
- [Transfer funds to or from an account](https://apidocs.seismic-cards.systems/api-reference/accounts/transfer-funds-to-or-from-an-account.md): Funds or depletes a debit (budget) account, or routes to prepaid card transfer-in/out when type is prepaid.
- [List issuer budgets](https://apidocs.seismic-cards.systems/api-reference/accounts/list-issuer-budgets.md): Returns budgets from the issuer for the applicant linked to this account.
- [Get program card-funding mode](https://apidocs.seismic-cards.systems/api-reference/card-funding/get-program-card-funding-mode.md): Returns whether the program uses Seismic wallet service or bring-your-own (BYO) external wallet funding.
- [Set program card-funding mode](https://apidocs.seismic-cards.systems/api-reference/card-funding/set-program-card-funding-mode.md): Configure wallet_service (default) or byo_wallet. For byo_wallet, byo.address is required — the user's external wallet they will send from.
- [Get card-funding deposit address](https://apidocs.seismic-cards.systems/api-reference/card-funding/get-card-funding-deposit-address.md): Returns the address to receive stablecoins for this applicant. In wallet_service mode, Seismic provides the deposit wallet. In byo_wallet mode, the user sends FROM their configured external wallet TO this same receive address. Pass program_id to apply that program's funding mode.
- [Get card-funding balances](https://apidocs.seismic-cards.systems/api-reference/card-funding/get-card-funding-balances.md): Returns deposit-wallet stablecoin balances and spendable USD available to fund cards for this applicant.
- [Fund card from deposit wallet](https://apidocs.seismic-cards.systems/api-reference/card-funding/fund-card-from-deposit-wallet.md): One-click: swaps deposited stablecoins to USD and tops up the prepaid card spend balance. Works for both wallet_service and byo_wallet after funds arrive at the deposit address. Idempotent when Idempotency-Key is set.
- [List cardholders](https://apidocs.seismic-cards.systems/api-reference/cardholders/list-cardholders.md)
- [Create a cardholder](https://apidocs.seismic-cards.systems/api-reference/cardholders/create-a-cardholder.md): Turns an approved applicant into a cardholder who can be issued cards. Requires applicant status APPROVED and a provisioned issuer account (POST /v1/applicants/{id}/submit or kyc-share first).
- [Get a cardholder](https://apidocs.seismic-cards.systems/api-reference/cardholders/get-a-cardholder.md): Returns the local cardholder record and, when live issuer is configured, issuer cardholder details.
- [Update a cardholder](https://apidocs.seismic-cards.systems/api-reference/cardholders/update-a-cardholder.md)
- [List cards](https://apidocs.seismic-cards.systems/api-reference/cards/list-cards.md)
- [Issue a card](https://apidocs.seismic-cards.systems/api-reference/cards/issue-a-card.md): Issues a virtual or physical card for a cardholder against a funding account. Prerequisites: applicant issuerKycReady true, funding account exists (POST /v1/accounts), cardholder exists (POST /v1/cardholders). First issuance provisions issuer budget and cardholder on the rail.
- [Batch issue cards](https://apidocs.seismic-cards.systems/api-reference/cards/batch-issue-cards.md): Issues up to 100 virtual or physical cards asynchronously. Returns issuer task_id and reference_ids for tracking. Prerequisites match single card issuance.
- [Get batch task progress](https://apidocs.seismic-cards.systems/api-reference/cards/get-batch-task-progress.md)
- [Batch delete cards](https://apidocs.seismic-cards.systems/api-reference/cards/batch-delete-cards.md): Deletes up to 100 cards asynchronously. Deleted cards are marked CLOSED locally.
- [Get a card](https://apidocs.seismic-cards.systems/api-reference/cards/get-a-card.md)
- [Update a card](https://apidocs.seismic-cards.systems/api-reference/cards/update-a-card.md): Updates the card label and/or monthly spend limit on the issuer.
- [Freeze a card](https://apidocs.seismic-cards.systems/api-reference/cards/freeze-a-card.md)
- [Unfreeze a card](https://apidocs.seismic-cards.systems/api-reference/cards/unfreeze-a-card.md)
- [Activate a card](https://apidocs.seismic-cards.systems/api-reference/cards/activate-a-card.md)
- [Close a card](https://apidocs.seismic-cards.systems/api-reference/cards/close-a-card.md): Permanently closes the card on the issuer and marks it CLOSED locally.
- [Fund a prepaid card](https://apidocs.seismic-cards.systems/api-reference/cards/fund-a-prepaid-card.md)
- [Withdraw from a prepaid card](https://apidocs.seismic-cards.systems/api-reference/cards/withdraw-from-a-prepaid-card.md)
- [Reveal token for Widget.js (PAN/CVV)](https://apidocs.seismic-cards.systems/api-reference/cards/reveal-token-for-widgetjs-pancvv.md): **Method 1 — Widget reveal (default).** Returns a short-lived `revealToken` (~5 minutes). Load Seismic Widget.js, then pass the token as `clientAccessToken` to `widget.bootstrap(...)`.
- [Widget.js (sandbox)](https://apidocs.seismic-cards.systems/api-reference/widget-sdk/widgetjs-sandbox.md): Public Seismic Widget.js (sandbox) for TEST / UAT `revealToken`s from `GET /v1/cards/{id}/secure-details`. No authentication. Use this URL in tenant integrations.
- [Widget.js (live)](https://apidocs.seismic-cards.systems/api-reference/widget-sdk/widgetjs-live.md): Public Seismic Widget.js (live) for LIVE `revealToken`s. No authentication. Use this URL in tenant integrations.
- [Server-side encrypted PAN/CVV (PCI DSS Level 1)](https://apidocs.seismic-cards.systems/api-reference/cards/server-side-encrypted-pancvv-pci-dss-level-1.md): **Method 2 — Server-side encrypted reveal.** PCI DSS Level 1 organizations only (`pciRevealEnabled` must be true).
- [List spend controls](https://apidocs.seismic-cards.systems/api-reference/cards/list-spend-controls.md): List MCC, scenario, or currency whitelist/blacklist rules for an applicant's issuer account.
- [Create or update a spend control](https://apidocs.seismic-cards.systems/api-reference/cards/create-or-update-a-spend-control.md)
- [Delete a spend control](https://apidocs.seismic-cards.systems/api-reference/cards/delete-a-spend-control.md)
- [Batch set spend controls](https://apidocs.seismic-cards.systems/api-reference/cards/batch-set-spend-controls.md)
- [List transactions](https://apidocs.seismic-cards.systems/api-reference/transactions/list-transactions.md)
- [List card transactions](https://apidocs.seismic-cards.systems/api-reference/transactions/list-card-transactions.md): Returns issuer transaction history when live rail is configured, otherwise local ledger rows.

## OpenAPI Specs

- [openapi](https://apidocs.seismic-cards.systems/openapi.json)