Skip to main content
Developer API

Build with the StampCard API

Integrate loyalty programs into your POS, mobile app, or website. Our REST API gives you full control over customers, passes, and transactions.

REST API

Full-featured REST API with JSON responses and JWT authentication.

Webhooks

Real-time notifications for stamps, redemptions, and customer events.

Real-time Updates

Instant pass updates synced to Apple Wallet and Google Wallet.

Secure by Design

OAuth 2.0, rate limiting, and enterprise-grade security.

Authentication

The StampCard API uses JWT (JSON Web Tokens) for authentication. Include your access token in the Authorization header of all requests.

Authorization: Bearer <your_access_token>

Getting Access Tokens

Obtain access tokens by calling the login endpoint with your credentials:

# Login to get tokens
curl -X POST https://api.stampcard.io/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "your_password"
  }'

Token Refresh

Access tokens expire after 15 minutes. Use the refresh token to obtain new access tokens:

curl -X POST https://api.stampcard.io/api/v1/auth/refresh \
  -H "Content-Type: application/json" \
  -d '{
    "refreshToken": "your_refresh_token"
  }'

Base URL

https://api.stampcard.io/api/v1

API Reference

Explore our complete API documentation. All endpoints follow REST conventions with JSON request/response bodies.

Authentication4 endpoints

User authentication, registration, and token management

Rate Limits

1000
Requests per minute
Standard Plan
5000
Requests per minute
Professional Plan
Custom
Requests per minute
Enterprise Plan

Rate limit headers are included in all responses: X-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-Reset

Ready to Integrate?

Sign up for a free account to get your API keys and start building today.