Developer Platform

Build on Ideal

The identity API for the physical world

One SDK to verify products, authenticate identities, track supply chains, and process payments. If it has an Ideal Code or Ideal Card, you can build with it.

Everything you need to build

Six APIs covering authentication, registry, tracking, payments, identity, and events. Production-ready, battle-tested, and fast.

Verify API

Authenticate any product or identity in <50ms. Real-time verification with confidence scoring.

POST /verify
View docs

Registry API

Register products, manage codes, bulk operations. Full lifecycle management for your product catalog.

POST /registry/products
View docs

Track API

Record handoffs, query chain of custody. Full provenance history for every product.

GET /track/{tic}
View docs

Pay API

Process payments, manage wallets, handle refunds. End-to-end transaction infrastructure.

POST /pay/charge
View docs

Identity API

Resolve Ideal.Bio profiles, verify card ownership. Portable digital identity for the physical world.

GET /identity/{username}
View docs

Events API

Manage tickets, check-ins, wristband provisioning. Complete event access infrastructure.

POST /events/{id}/checkin
View docs

Interactive code playground

See how simple it is to integrate. Copy, paste, ship.

Python
Node.js
Go
cURL
verify_product.py
import ideal

client = ideal.Client("sk_live_...")

# Verify a product
result = client.verify("TIC-P-0049000042566")
print(result.authentic)    # True
print(result.confidence)   # 0.98
print(result.product.name) # "Coca-Cola Classic"

# Register a new product
product = client.registry.create(
    name="My Product",
    category="electronics",
    manufacturer="My Company"
)
print(product.tic)  # "TIC-P-..."
verify_product.js
const Ideal = require('@ideal/sdk');

const client = new Ideal.Client('sk_live_...');

// Verify a product
const result = await client.verify('TIC-P-0049000042566');
console.log(result.authentic);    // true
console.log(result.confidence);   // 0.98

// Register a new product
const product = await client.registry.create({
  name: 'My Product',
  category: 'electronics',
  manufacturer: 'My Company'
});
console.log(product.tic);  // "TIC-P-..."
main.go
package main

import (
    "fmt"
    "github.com/ideal-ecosystem/ideal-go"
)

func main() {
    client := ideal.NewClient("sk_live_...")

    // Verify a product
    result, _ := client.Verify("TIC-P-0049000042566")
    fmt.Println(result.Authentic)   // true
    fmt.Println(result.Confidence)  // 0.98
}
terminal
curl -X POST https://api.ideal.bio/v1/verify \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "tic": "TIC-P-0049000042566"
  }'

Your language, our SDK

Official client libraries maintained by the Ideal team. Install in seconds, start building immediately.

Py

Python

pip install ideal
2.4M downloads
JS

Node.js

npm install @ideal/sdk
1.8M downloads
Go

Go

go get github.com/ideal-ecosystem/ideal-go
890K downloads
Jv

Java

implementation 'bio.ideal:sdk:2.4.0'
640K downloads
Rb

Ruby

gem install ideal
420K downloads
PH

PHP

composer require ideal/sdk
380K downloads
Sw

Swift

.package(url: "ideal-swift", from: "2.4.0")
310K downloads
Kt

Kotlin

implementation("bio.ideal:sdk:2.4.0")
270K downloads

Plug into your stack

First-party integrations with the platforms you already use. No-code setup in minutes.

Shopify
WooCommerce
Stripe
Square
Zapier
AWS
Google Cloud

Start free, scale infinitely

Simple, transparent pricing. No hidden fees. Pay only for what you use.

Free

$0 /mo

For side projects and prototyping.

  • 1,000 API calls/month
  • All 6 APIs
  • Community support
  • Test mode

Growth

$49 /mo

For growing businesses going live.

  • 100,000 API calls/month
  • All 6 APIs
  • Email support
  • Dashboard analytics

Enterprise

Custom

For organizations with bespoke needs.

  • Unlimited API calls
  • Dedicated infrastructure
  • 99.99% SLA
  • Dedicated support engineer
  • Custom integrations
The Ideal Code — QR Codes
The Ideal Card — NFC Cards
Ideal.Bio — Link in Bio
Ideal Pay — Wallet
Ideal Events — Ticketing
The Ideal POS — Register