Overview
API Reference
Technical reference for all KemyCard API endpoints
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Technical reference for all KemyCard API endpoints
https://api.kemycard.com/v1
Authorization: Bearer sk_test_YOUR_API_KEY
{
"success": true,
"data": { "..." },
"meta": {
"request_id": "a4f8e2c1b3d97056",
"mode": "test",
"timestamp": "2026-06-28T14:30:00+00:00"
},
"pagination": {
"page": 1,
"limit": 20,
"total": 42,
"pages": 3
}
}
| Field | Present | Description |
|---|---|---|
success | Always | true on success, false on error |
data | On success | The response payload |
error | On error | Error details (code, message, details) |
meta | Always | Request ID, mode (test/live), timestamp |
pagination | List endpoints only | Page info |
| Param | Type | Default | Max | Description |
|---|---|---|---|---|
page | int | 1 | — | Page number |
limit | int | 20 | 100 | Items per page |
| Method | Endpoint | Description |
|---|---|---|
POST | /customers | Create a customer |
GET | /customers | List customers |
GET | /customers/{code} | Get a customer |
PATCH | /customers/{code} | Update a customer |
POST | /customers/{code}/suspend | Suspend a customer |
POST | /customers/{code}/activate | Activate a customer |
GET | /balance | Get ops balance summary |
GET | /balance/transactions | List ops transactions |
cards or all_in_one| Method | Endpoint | Description |
|---|---|---|
GET | /cards/products | List available card products (catalog) |
GET | /cards/products/{code} | Get card product details |
POST | /cards | Create a card |
GET | /cards | List cards |
GET | /cards/{code} | Get a card |
POST | /cards/{code}/freeze | Freeze a card |
POST | /cards/{code}/topup | Top up a card |
POST | /kyc/{customerCode}/link | Get the KYC verification link |
GET | /kyc/{customerCode}/status | Get KYC status |
wallets or all_in_one| Method | Endpoint | Description |
|---|---|---|
POST | /wallets | Create a wallet |
GET | /wallets | List wallets |
virtual_accounts or all_in_one| Method | Endpoint | Description |
|---|---|---|
POST | /virtual-accounts | Create a virtual account |
GET | /virtual-accounts | List virtual accounts |
gift_cards or all_in_one| Method | Endpoint | Description |
|---|---|---|
GET | /gift-cards/catalog | Browse gift card catalog |
POST | /gift-cards/orders | Purchase a gift card |
| Method | Endpoint | Description |
|---|---|---|
POST | /webhooks | Create a webhook endpoint |
GET | /webhooks | List webhook endpoints |
GET | /webhooks/events | List available events |
GET | /webhooks/{code} | Get a webhook endpoint |
PATCH | /webhooks/{code} | Update a webhook endpoint |
POST | /webhooks/{code}/rotate-secret | Rotate the HMAC secret |
POST | /webhooks/{code}/ping | Send a test ping |
GET | /webhooks/{code}/deliveries | List delivery history |