v2.0

CoffeeCanz API Documentation

RESTful API for seamless integration with POS, payment processors, and enterprise systems. Built for scale and acquisition-ready.

Quick Start

Contact partnerships@coffeecanz.com for API credentials

Include API key in Authorization header

Make requests to endpoints below

Authentication Example

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.coffeecanz.com/v2/deals

GET

/api/deals

List all active deals with filtering

Query Parameters:

city

category

discount_min

type

Response:

{
  "deals": [],
  "total": 0,
  "page": 1
}

POST

/api/redemptions

Create a new redemption

Request Body:

{
  "deal_id": "string",
  "user_email": "string"
}

Response:

{
  "redemption_id": "string",
  "voucher_code": "string"
}

GET

/api/redemptions/:id/validate

Validate a voucher code

Response:

{
  "valid": true,
  "deal": {},
  "expires_at": "timestamp"
}

Toast, Square, Clover integration via webhooks

/api/webhooks/pos/redemption/api/pos/sync

Stripe, PayPal transaction data

/api/payments/webhook/api/payments/reconcile

DoorDash, Uber Eats fulfillment sync

/api/fulfillment/orders/api/fulfillment/status

Standard Tier:1,000 req/hour

Enterprise Tier:10,000 req/hour

Burst Limit:100 req/min

Uptime:99.9%

Response Time:< 200ms

Support:24/7