> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.seismic-cards.systems/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> One white-labeled API to issue and manage cards on Seismic.

The **Seismic Card Issuance API** is the integration surface for launching a card program. Authenticate with your **Seismic API key**, onboard applicants, run KYC, and issue virtual or physical cards. Portal setup (organizations, programs, billing) is handled in the dashboard — this documentation covers the card integration flow only.

<CardGroup cols={2}>
  <Card title="Seismic keys only" icon="key">
    Exchange a `client_id` + `client_secret` for a short-lived bearer token. That's the only credential your services ever hold.
  </Card>

  <Card title="Fully white-labeled" icon="wand-magic-sparkles">
    Responses expose Seismic resources only — no upstream provider names, ids, or keys ever leak to your app.
  </Card>

  <Card title="Consistent envelopes" icon="file-json">
    Every resource response is wrapped in `{ "data": … }`; every error is `{ "error": { "code", "message" } }`.
  </Card>

  <Card title="Interactive reference" icon="square-terminal" href="/api-reference">
    Try any endpoint from the browser against your sandbox with your bearer token.
  </Card>
</CardGroup>

## How it fits together

```mermaid theme={null}
flowchart LR
  A[API key] -->|/v1/oauth/token| B[Access token]
  B --> C[Applicant]
  C -->|Tenant KYC| D[APPROVED]
  D -->|Issuer KYC| E[issuerKycReady]
  E --> F[Cardholder]
  H[Account] --> I[Card]
  F --> I
```

## Base URL

| Environment | Base URL                            |
| ----------- | ----------------------------------- |
| Live & Test | `https://api.seismic-cards.systems` |

There is **one base URL**. Whether a request runs in **test** or **live** mode is determined by the **API key** you authenticate with — test keys operate against a fully functional sandbox with no real money movement, and live keys move real funds. Every path in this documentation is relative to this host, so you can copy, paste, and run the examples as-is with a test key.

## Documentation map

| Section                                                       | Purpose                                                  |
| ------------------------------------------------------------- | -------------------------------------------------------- |
| [Quickstart](/quickstart)                                     | Authenticate and issue your first card                   |
| [Authentication](/authentication)                             | API keys and bearer tokens                               |
| [KYC integration](/guides/kyc-integration)                    | Hosted verification, BYOK share tokens, issuer readiness |
| [Applicants](/concepts/applicants) & [Cards](/concepts/cards) | Core objects in the card flow                            |
| [Responses](/guides/responses) & [Errors](/guides/errors)     | Envelope shapes and error codes                          |
| [API Reference](/api-reference)                               | Card integration endpoints with a live playground        |