APIs
Account
Users, organizations, memberships, API keys. RBAC with Owner, Manager, Billing, and Editor roles.
Products
GTIN-based product catalog. Supports GTIN-8/12/13/14 with automatic normalization to GTIN-14. Includes data provenance, confidence scores, and GPC classification.
Brands
Brand ownership, claiming, and management. Brands are linked to organizations and products.
Locations
Physical store and service locations with PostGIS coordinates. Used for distance-based search ranking.
Retailers
Offers, inventory, pricing, and retailer data. Includes regional overrides and inventory confidence levels.
Search
Hybrid search with semantic embeddings (1024-dim), lexical matching, and geographic proximity. Conversational sessions with constraint accumulation.
GS1 Digital Link
GTIN resolution via Digital Link URIs. Configurable rules with scope hierarchy, time-based routing, and custom destinations.
EPCIS 2.0
Supply chain event capture and query per ISO/IEC 19987:2024. Five event types with full CBV 2.0 vocabulary.
Integrations
POS connections (Shopify, Square, Clover, Lightspeed) and webhook management with signed payloads and delivery tracking.
Billing
Stripe-based subscriptions, resolver tiers (Free/Business), and usage metering for API calls, lookups, and webhook deliveries.
Scanner
Barcode and product image scanning. Supports barcode, image, and manual capture modes with vision extraction proposals.
Compliance
Product recalls, safety notices, and supply chain traceability.
Certifications
Product certification management and verification.
Sustainability
Sustainability data, certifications, and environmental tracking.
Notifications
Multi-channel notification delivery (email, Slack, SMS).
Advertising
Ad campaigns, impressions, revenue share, and reporting.
Dashboard
Analytics, performance snapshots, and observability data.
Content
Product readiness checks and content management.
Common Conventions
See Authentication, Rate Limits, and Errors for shared patterns.| Convention | Details |
|---|---|
| Base URL | https://www.closient.com |
| Auth | X-API-Key: <prefix>_<body>_<checksum> |
| Rate limit | 300/min, 10,000/day per key (configurable) |
| Pagination | ?page=1&page_size=25 (max 100) |
| Errors | { "error": { "code", "message", "status", "details" } } |
| IDs | nanoid: 12 chars, alphabet aceghjkpqrtwxy346789 |
| Timestamps | ISO 8601 UTC |