Errors

← Back to API Integration Errors behave the same way across the whole API, so they live here instead of under every endpoint.

401 — Unauthorised

The key is missing, malformed, or not recognised. Returns a flat error string.

{ "error": "Invalid API key" }

404 — Not found

The partner or resource behind your key has no matching record.

{ "success": false, "error": "partner.not-found" }

422 — Validation failed

A required parameter is missing or out of range. errors lists each field.

{
  "message": "The type field is required.",
  "errors": { "type": ["The type field is required."] }
}

Watch out: some giveaway responses return 200 with success: false — an already-claimed offer or an exhausted code pool is a valid outcome, not a failure. Always branch on success as well as the status code.

Last modified on August 25, 2026

Integration Documentation

Getting Started

Platform

Integration

Features