Documentation

Everything you need to integrate, authenticate, and trace — in one place.

API guides, SDK references, webhook documentation, compliance schemas, and integration tutorials for every Ratifye platform component.

Quick start

Get your first authenticated barcode in under 30 minutes.

1

Get your API credentials

Create a free account at app.ratifye.ai. Navigate to Settings API Keys Generate new key. Your key is active immediately on the free tier with 500 authentications/month.

2

Generate your first barcode

POST your GTIN and optional batch/serial/expiry to the /generate endpoint. The response includes your signed barcode data ready for printing.

3

Verify authentication

POST any scanned barcode payload to /authenticate. Response returns Authentic, Diverted, or Counterfeit with full GS1 data decoded and signature verification.

Documentation sections

Complete reference for every platform component.

Authentication API

Verify barcodes, decode GS1 data, handle Authentic / Diverted / Counterfeit results

Barcode Generation API

Generate EAN-13, DataMatrix, QR, GS1 Digital Link with ECDSA signing

Event & Trace API

Submit scan events, query chain of custody, CDSCO and FSSAI event schemas

Webhooks

Real-time event streaming for counterfeit and diversion alerts to your systems

SDK Reference

iOS Swift, Android Kotlin, React Native, and Zebra DataWedge SDKs

Platform

The technology underneath