SDKs

Official Zillo SDKs are on the roadmap. In the meantime the JSON API is straightforward and works from any language — curl examples below.

Generate your own

Use the OpenAPI 3.1 spec with any generator — openapi-generator covers 20+ languages and Fern produces idiomatic clients.

# TypeScript SDK with openapi-generator
openapi-generator-cli generate \
  -i https://api.zillo.app/v1/openapi.json \
  -g typescript-fetch \
  -o ./zillo-sdk

Plain HTTP examples

List products

curl -H "Authorization: Bearer zk_live_xxx" \
  https://api.zillo.app/v1/products?limit=10

Create a customer

curl -X POST https://api.zillo.app/v1/customers \
  -H "Authorization: Bearer zk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"email":"alice@example.com","name":"Alice"}'

Create a manual order

curl -X POST https://api.zillo.app/v1/orders \
  -H "Authorization: Bearer zk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": { "email": "alice@example.com" },
    "items": [
      { "product_id": "...", "quantity": 1 }
    ],
    "payment_method": "manual"
  }'

Redeem a gift card

curl -X POST https://api.zillo.app/v1/gift_cards/<id>/redeem \
  -H "Authorization: Bearer zk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"amount_cents": 1500, "note": "Coffee — table 4"}'