> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apocor.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

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

The **Apocor Cards API** is the integration surface for launching a card program. Authenticate with your **Apocor 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="Apocor 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 Apocor 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 URLs

| Environment | Base URL                               |
| ----------- | -------------------------------------- |
| Sandbox     | `https://sandbox.apocor.ai`            |
| Production  | `https://api.apocor.com` (coming soon) |
| Local       | `http://localhost:4000`                |

Every path in this documentation is relative to one of these hosts. All examples target the **sandbox** — a live, fully functional environment with no real money movement — so you can copy, paste, and run them as-is.

## 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        |