Loading...
Loading...
Integrate 2,000+ digital gift cards and vouchers directly into your platform. All endpoints require a valid API key.
https://api.fastcodes.ioAll requests must include your API key as a Bearer token in the Authorization header. Keys are prefixed with fc_live_sk_ for production and fc_test_sk_ for sandbox.
curl https://api.fastcodes.io/v1/products \
-H "Authorization: Bearer fc_live_sk_••••••••••••••••"Never expose your API key client-side. Rotate keys immediately from your dashboard if compromised.
Returns a paginated list of all available digital gift card products in your catalog.
| Name | Type | Required | Description |
|---|---|---|---|
| category | string | optional | Filter by category slug (e.g. gaming, entertainment) |
| country | string | optional | ISO 3166-1 alpha-2 country code (e.g. US, GB) |
| page | integer | optional | Page number, default 1 |
| limit | integer | optional | Results per page (max 100), default 20 |
{
"data": [
{
"id": "prod_9xKm2Lz",
"name": "Steam Wallet $50",
"brand": "Steam",
"category": "gaming",
"currency": "USD",
"face_value": 50,
"wholesale_price": 47.5,
"stock": "available",
"countries": [
"US",
"CA",
"GB"
],
"image_url": "https://cdn.fastcodes.io/steam-50.png"
}
],
"meta": {
"total": 2148,
"page": 1,
"limit": 20
}
}Returns all top-level product categories with product counts.
{
"data": [
{
"slug": "gaming",
"label": "Gaming",
"product_count": 412
},
{
"slug": "entertainment",
"label": "Entertainment",
"product_count": 318
},
{
"slug": "shopping",
"label": "Shopping",
"product_count": 276
},
{
"slug": "food",
"label": "Food & Drink",
"product_count": 195
},
{
"slug": "travel",
"label": "Travel",
"product_count": 143
}
]
}Purchase one or more gift card codes. Codes are returned instantly in the response when stock is available.
{
"product_id": "prod_9xKm2Lz",
"quantity": 2,
"idempotency_key": "order_abc123_retry1"
}{
"id": "ord_7Fq3mNpR",
"status": "fulfilled",
"product_id": "prod_9xKm2Lz",
"quantity": 2,
"unit_price": 47.5,
"total": 95,
"codes": [
{
"code": "STMW-X4K9-PLMQ-7RVB",
"pin": null,
"expires_at": null
},
{
"code": "STMW-H2N1-WRXT-5DCG",
"pin": null,
"expires_at": null
}
],
"created_at": "2026-08-29T14:32:01Z"
}Returns your current prepaid balance and credit limit across all currencies.
{
"balances": [
{
"currency": "USD",
"available": 12450,
"reserved": 95
}
],
"credit_limit": 50000,
"account_status": "active"
}| Code | Status | Meaning |
|---|---|---|
| 200 | OK | Request succeeded. |
| 201 | Created | Order created and fulfilled. |
| 400 | Bad Request | Missing or invalid parameters. |
| 401 | Unauthorized | Invalid or missing API key. |
| 402 | Payment Required | Insufficient account balance. |
| 404 | Not Found | Product or order does not exist. |
| 409 | Conflict | Duplicate idempotency key with different params. |
| 429 | Too Many Requests | Rate limit exceeded. |
| 500 | Server Error | Unexpected error — contact support. |
Get your API key and start fulfilling digital gift cards in minutes.