Developer API

Connect your platform to Ownich.

A clean, well-documented REST API for businesses that want to embed digital ownership infrastructure directly into their existing systems — with full mobile, sandbox, and production support.

Talk to Ownich

How it connects

Simple integration flow

Your Platform
Ownich API
Digital Ownership Record

API at a glance

Key specs — versioning, limits, environments.

Everything your team needs to plan an integration — rate limits by plan tier, pagination rules, file upload constraints, and both sandbox and production base URLs.

API version

v1 (implicit)

URL-path versioning on breaking changes · 90-day deprecation notice

Rate limits

60–1 000 req/min

Free · Pro · Enterprise tiers · 429 + Retry-After on breach

Pagination

Offset-based

?page · ?limit (max 100) · ?q search · ?sort · ?order

File upload

Multipart or base64

JPEG · PNG · WebP · 10 MB max · 20 uploads/hour

Sandbox URL

preview.sandbox.app

Isolated data · Stripe test cards · 7-day auto-purge

Production URL

ownich.io/api/

TLS 1.2+ · 99.9% SLA · 30s timeout · Bearer-only auth

Environments

Sandbox and production, clearly separated.

Build and test against a fully isolated sandbox before pointing at production. Same API, same auth flow — different base URL.

Sandbox / testTEST
Base URLpreview.sandbox.app/api/
AuthSame Bearer token flow — use a test account
DataFully isolated — no effect on live certificates
PaymentsStripe test card 4242 4242 4242 4242
Rate limits500 req/min per user — relaxed for testing
Fraud triggerSerial TEST-FRAUD-001 returns a blocked response
Data resetAuto-purged every 7 days
ProductionLIVE
Base URLhttps://ownich.io/api/
TLSTLS 1.2+ required — HTTP redirects to HTTPS
AuthBearer token in Authorization header only
CORSownich.io + registered partner domains; mobile exempt
Uptime SLA99.9% monthly — status.ownich.io
Timeout30s — implement exponential back-off on 5xx
IP allowlistNot required — Bearer token is the credential

Rate limits

Per-plan request limits.

All limits return 429 with a Retry-After header on breach. Use exponential back-off starting at 1 s.

TierLimitScope
Unauthenticated30 req / minPer IP
Free plan60 req / minPer user
Pro plan300 req / minPer user
Enterprise1 000 req / minPer org
Login endpoint10 req / 15 minPer IP
Upload endpoint20 req / hourPer user

For developers

Everything you need to build.

From sandbox testing to production webhooks — the Ownich API is built for developers who want to move fast without compromising on reliability.

Full API documentation

262 documented endpoints covering certificates, transfers, KYC, admin, rewards, and more — with copy-ready examples for every call.

Mobile API docs

Dedicated mobile reference covering token lifecycle, QR scan flow, image upload, pagination, rate limits, versioning, and sandbox/production environments.

API key management

Issue and revoke API keys per integration. Scoped access for read-only or full write. Org-level keys for enterprise partners.

Bearer token auth

Secure every request with Bearer tokens. Mobile-friendly long-lived 96-char hex token exchange with device labelling.

Webhooks

Receive real-time events for certificate creation, transfers, KYC decisions, fraud flags, and rewards milestones.

Sandbox environment

Test your integration end-to-end without affecting live data. Relaxed rate limits, isolated data, and a TEST-FRAUD-001 serial trigger.

API capabilities

What you can build with the Ownich API.

The API covers the full digital ownership lifecycle — from first registration through every transfer, verification, and dispute.

Register items and create digital ownership certificates
Initiate and accept ownership transfers
Verify certificate integrity via QR or ID
Manage certificate visibility (private / shareable / public)
Trigger KYC sessions via Didit integration
Receive webhook events for all ownership lifecycle events
Query asset hub listings
Re-issue certificates with updated details
Report and manage stolen asset flags
Access transfer history and provenance chain
Upload certificate photos (multipart or base64)
Evaluate and award challenge / rewards points

Documentation

All the docs in one place.

Full API reference, mobile-specific docs, Flutter SDK guide, and the developer portal — all password-protected and ready for your team.

Integrations

Connect the systems you already use.

Ownich sits alongside your existing infrastructure — not instead of it.

E-commerce platforms
Retail POS systems
Marketplaces
CRM systems
Payment gateways
Verification services
Valuation services
Webhook consumers

Ready to integrate?

Start building with the Ownich API.

Access the full API reference, mobile docs, Flutter guide, and developer portal — or talk to the team about your integration requirements.

Talk to Ownich