> For the complete documentation index, see [llms.txt](https://docs.zebec.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zebec.io/developer-docs/partner-api.md).

# Partner API

The **Zebec Partner API (v1)** is a B2B surface for partners integrating Carbon card issuance, top-ups, and end-user 2FA on behalf of their users.

**Base URLs**

* Sandbox: `https://dev-super.api.zebec.io/`
* PROD: `https://super.api.zebec.io`

**Swagger UI:** <https://dev-super.api.zebec.io/api/partner>

## What you can do

* Send and verify OTPs for end users under your partner.
* Read Carbon card metadata and transaction history.
* Discover top-up programs, build quotes, and submit signed top-ups.

## Endpoint summary

| Method | Path                             | Purpose                                                    |
| ------ | -------------------------------- | ---------------------------------------------------------- |
| POST   | `/partner/v1/auth/otp/send`      | Send an OTP to a user email                                |
| POST   | `/partner/v1/auth/otp/verify`    | Verify OTP and get a delegation token                      |
| GET    | `/partner/v1/cards`              | Get card metadata (no PAN/CVV)                             |
| GET    | `/partner/v1/cards/transactions` | List card transactions                                     |
| GET    | `/partner/v1/topup/programs`     | Discover available Carbon programs, currencies, and tokens |
| GET    | `/partner/v1/topup/quote`        | Build a top-up quote (2-minute TTL)                        |
| POST   | `/partner/v1/topup/preflight`    | Run preflight checks against a live quote                  |
| POST   | `/partner/v1/topup`              | Submit a signed top-up against a quote                     |
| GET    | `/partner/v1/topup/{orderId}`    | Poll top-up status                                         |

## Guides

* [Authentication](/developer-docs/partner-api/authentication.md)
* [Cards](/developer-docs/partner-api/cards.md)
* [Top-up flow](/developer-docs/partner-api/topup-flow.md)

## Getting access

Partner API credentials are issued by Zebec admin. Contact your Zebec partner engineer or <support@zebec.io> to request access.