# Closient

## Documentation

### Getting Started

- [Introduction](https://docs.closient.com/introduction.md): Build on the world's product graph with the Closient API.
- [First Steps](https://docs.closient.com/first-steps.md): Just signed up? Here's how to get started with Closient in 10 minutes.
- [Quickstart](https://docs.closient.com/quickstart.md): Get up and running with the Closient API in under 5 minutes.
- [Authentication](https://docs.closient.com/authentication.md): API key types, formats, RBAC roles, and security practices.

### Developer Questions

- [Developer Questions](https://docs.closient.com/prompts/index.md): How developers and AI agents actually ask about product data, barcode lookup, and GS1 Digital Link — and where to find the answers.
- [How AI Agents Use Closient](https://docs.closient.com/prompts/mcp-for-ai-agents.md): How AI agents look up products from barcodes, resolve GTINs to product data, and answer GS1 Digital Link questions using the Closient MCP server.
- [MCP Server vs REST API](https://docs.closient.com/prompts/api-vs-mcp.md): When to use the Closient MCP server vs the REST API for AI agent integration, custom backends, and developer tooling.
- [Closient vs Building Your Own Resolver](https://docs.closient.com/prompts/build-vs-buy.md): What it actually takes to build a GTIN resolver, GS1 Digital Link service, or product graph in-house — and where a hosted platform pays off.

### User Guides

- [Managing Products](https://docs.closient.com/user-guides/managing-products.md): How to add, edit, and organize products in your catalog.
- [Claiming Your Brand](https://docs.closient.com/user-guides/claiming-your-brand.md): How to claim ownership of your brand and products in Closient.
- [Setting Up Resolver Rules](https://docs.closient.com/user-guides/resolver-rules.md): Configure where your GS1 Digital Link barcodes direct consumers and partners.
- [Connecting Your POS](https://docs.closient.com/user-guides/connecting-pos.md): Sync inventory and product data from your point-of-sale system.
- [Team Management](https://docs.closient.com/user-guides/team-management.md): Invite team members and manage roles within your organization.
- [Understanding Analytics](https://docs.closient.com/user-guides/analytics.md): How to read scan data, search analytics, and product performance.
- [Barcode Scanning](https://docs.closient.com/user-guides/barcode-scanning.md): How to use the scanner for product lookup, data capture, and inventory management.
- [Printing QR Labels](https://docs.closient.com/user-guides/printing-labels.md): Pick label stock, preview the sheet, and export print-ready QR label PDFs for your products, lots, and serials.
- [QR Code Sizing](https://docs.closient.com/user-guides/qr-code-sizing.md): Why your QR code is the size it is — modules, versions, X-dimension, and the data length that decides all three. With retail POS size tables in mm and inches.
- [Searching for Products](https://docs.closient.com/user-guides/searching-products.md): How to find products at nearby stores using Closient's local search.

### Technical Guides

- [GS1 Digital Link Resolution](https://docs.closient.com/guides/digital-link-resolution.md): Resolve GTINs to structured product data using configurable resolution rules.
- [AB 660 / Date Labels](https://docs.closient.com/guides/ab-660-date-labels.md): How Closient renders GS1 date Application Identifiers (15/16/17/7003) as consumer-facing strings under California AB 660, and how the Products API enforces banned-phrase validation.
- [Lot-Scoped Recalls](https://docs.closient.com/guides/lot-scoped-recalls.md): Which GS1 Application Identifiers a lot-managed product needs so a recall can be scoped to specific lots, and how resolver rules turn that identity into scan-time recall status.
- [Serial Verification (gs1:verificationService)](https://docs.closient.com/guides/verification-service.md): Verify serialized GTIN scans against the Closient resolver — tiered, rate-limited, enumeration-safe.
- [EPCIS 2.0 Events](https://docs.closient.com/guides/epcis-events.md): Capture and query supply chain visibility events per ISO/IEC 19987:2024.
- [EPCIS 2.0 Conformance](https://docs.closient.com/guides/epcis-conformance.md): The roles, binding, and industry profiles Closient's EPCIS 2.0 implementation claims — and states plainly which it does not.
- [Webhooks](https://docs.closient.com/guides/webhooks.md): Receive real-time HTTP callbacks when events occur in your Closient account.
- [Data Delivery](https://docs.closient.com/guides/data-delivery.md): Nightly delivery of your scan and page-visit aggregates to your own S3, R2 or Postgres.
- [Rate Limits & Pagination](https://docs.closient.com/rate-limits.md): Understand API rate limits, response headers, and pagination conventions.
- [Metadata](https://docs.closient.com/metadata.md): Attach your own key/value data to any Closient API resource.
- [Errors](https://docs.closient.com/errors.md): Standard error responses across all Closient APIs.

### MCP Server

- [Install the Closient MCP Server](https://docs.closient.com/guides/mcp-install.md): Connect Claude, Cursor, VS Code, and other MCP-compatible AI tools to Closient in one click or with a single command.
- [MCP Quickstart](https://docs.closient.com/guides/mcp-quickstart.md): Connect Claude to Closient and resolve your first GTIN in under two minutes.
- [MCP Tool Reference](https://docs.closient.com/guides/mcp-tools.md): Input schemas, output shapes, and example calls for every tool exposed by the Closient MCP server.
- [MCP Authentication](https://docs.closient.com/guides/mcp-authentication.md): How OAuth 2.1 step-up authorization works for the Closient MCP server's protected tools.
- [MCP Error Contract](https://docs.closient.com/guides/mcp-errors.md): How Closient's MCP tools surface errors — JSON-RPC envelopes carrying RFC 9457 Problem Details.
- [MCP Identity Propagation](https://docs.closient.com/guides/mcp-identity.md): How Closient's MCP server distinguishes the agent making a call from the end user on whose behalf it acts.
- [MCP Tool Annotations](https://docs.closient.com/guides/mcp-tool-annotations.md): How Closient's MCP tools advertise their side-effect profile — readOnlyHint and destructiveHint.
- [Anthropic Connectors Directory — Reviewer Guide](https://docs.closient.com/guides/mcp-reviewer-guide.md): Step-by-step walkthrough for Anthropic reviewers vetting the Closient MCP server submission.

### Agent Skills

- [Agent Skills](https://docs.closient.com/agent-skills/overview.md): What an AI agent can do with Closient — a discoverable, version-pinned set of skills published at /.well-known/agent-skills/.
- [Local Product Search](https://docs.closient.com/agent-skills/local-product-search.md): Find products available at nearby physical retail stores, ranked by proximity and inventory confidence.
- [Hyperlocal Nearby](https://docs.closient.com/agent-skills/hyperlocal-nearby.md): Discover what's interesting near the user right now — new arrivals, local-independent retailers, time-sensitive offers.
- [Check Product Availability](https://docs.closient.com/agent-skills/check-product-availability.md): Given a known GTIN and a location, find nearby stores stocking that product with stock status and pricing.
- [Check Recalls](https://docs.closient.com/agent-skills/check-recalls.md): Check recalls and safety notices for a product by GTIN, optionally narrowed to a specific batch/lot (AI 10), with severity and source agency.
- [Find Alternative](https://docs.closient.com/agent-skills/find-alternative.md): Find an alternative product that matches user constraints (certifications, substances to avoid, dietary preferences) near a location.
- [Compare Products](https://docs.closient.com/agent-skills/compare-products.md): Side-by-side comparison of two or more products on price, certifications, ingredients, and provenance.
- [Plan Shopping Trip](https://docs.closient.com/agent-skills/plan-shopping-trip.md): Given a shopping list and a user location, figure out the minimum number of stores needed and a sensible order to visit them.
- [Dietary Filter Search](https://docs.closient.com/agent-skills/dietary-filter-search.md): Search for products constrained by stored dietary, allergen, religious, or sourcing preferences.
- [Resolve GTIN](https://docs.closient.com/agent-skills/resolve-gtin.md): Resolve a GTIN (8/12/13/14-digit product barcode) via GS1 Digital Link to structured product information.
- [Brand Scan Summary](https://docs.closient.com/agent-skills/brand-scan-summary.md): Report a brand's most-scanned products over a time range, with country and device breakdown.
- [Brand Search Demand](https://docs.closient.com/agent-skills/brand-search-demand.md): Report where people are searching for a brand's products, with metro/city-level geographic breakdown.
- [Brand Retail Footprint](https://docs.closient.com/agent-skills/brand-retail-footprint.md): Map a brand's retail distribution — which stores carry their products, stock signals, and distribution gaps.
- [Claim Brand](https://docs.closient.com/agent-skills/claim-brand.md): Walk a brand owner through claiming an existing unclaimed Brand on Closient or creating + claiming a new one, then linking it to their Organization.
- [Create Product](https://docs.closient.com/agent-skills/create-product.md): Create a new product (GTIN) and claim it for a brand-owner organization — the programmatic equivalent of the dashboard "Add product" page.
- [Edit Product Basic Info](https://docs.closient.com/agent-skills/edit-product-basic-info.md): Update a claimed product's identity fields (name, brand, description, manufacturer, origin, etc.) — the programmatic equivalent of the dashboard product-edit page.
- [Edit Product Dimensions & Weight](https://docs.closient.com/agent-skills/edit-product-dimensions.md): Update a product's physical dimensions and weight (length/width/height/depth, gross/net weight) — the programmatic equivalent of the dashboard's dimensions & weight page.
- [Edit Product Classification (GPC)](https://docs.closient.com/agent-skills/edit-product-classification.md): Update a product's GS1 Global Product Classification (GPC) codes — the programmatic equivalent of the dashboard's classification page.
- [Edit Product Images](https://docs.closient.com/agent-skills/edit-product-images.md): Upload, list, and delete a product's images — the programmatic equivalent of the dashboard's images page.
- [Edit Product Ingredients](https://docs.closient.com/agent-skills/edit-product-ingredients.md): Update a product's raw ingredient list text and trigger substance parsing — the programmatic equivalent of the dashboard's ingredients page.
- [Edit Product Nutrition](https://docs.closient.com/agent-skills/edit-product-nutrition.md): Create, update, and delete a product's nutrition-facts panel and nutrient rows — the programmatic equivalent of the dashboard's nutrition page.
- [Edit Product Documents](https://docs.closient.com/agent-skills/edit-product-documents.md): Upload, update, list, and delete a product's PDF documents — the programmatic equivalent of the dashboard's documents page.
- [Edit Product Videos](https://docs.closient.com/agent-skills/edit-product-videos.md): Add, update, list, and delete a product's YouTube video links — the programmatic equivalent of the dashboard's videos page.
- [Onboard Retailer](https://docs.closient.com/agent-skills/onboard-retailer.md): Walk a retailer through connecting their POS, syncing initial inventory, and publishing their first physical store Location on Closient.
- [Closient API Quickstart](https://docs.closient.com/agent-skills/closient-api-quickstart.md): Zero-to-first-call quickstart for any agent integrating with Closient — discover APIs, register an OAuth client (RFC 7591) or get an API key, complete an authorization_code + PKCE flow, make the first authenticated request, and debug the common 401/403/429 failure modes.
- [Decode GS1 AI](https://docs.closient.com/agent-skills/decode-gs1-ai.md): Parse a GS1 Application Identifier (AI) element string — bracketed or unbracketed — into structured key/value pairs, distinguishing fixed-length AIs (GTIN, dates) from variable-length AIs that require an FNC1 separator.
- [Build GS1 Digital Link](https://docs.closient.com/agent-skills/build-gs1-digital-link.md): Given a GTIN and optional AIs (batch/lot, serial, expiry, etc.), construct a valid canonical GS1 Digital Link URI suitable for resolver hosting, QR encoding, or sharing with downstream systems.
- [Closient OpenAPI Tour](https://docs.closient.com/agent-skills/closient-openapi-tour.md): Bird's-eye tour of the 22 per-app OpenAPI surfaces under Closient — what each app owns, where to find a specific endpoint via the RFC 9727 API catalog, and the cross-cutting conventions (auth, pagination, error envelope, rate-limit headers, idempotency) that apply uniformly.
- [Capture EPCIS Event](https://docs.closient.com/agent-skills/capture-epcis-event.md): Record a GS1 EPCIS 2.0 supply-chain event (Object / Aggregation / Transaction / Transformation / Association) against the authenticated organization, optionally materializing an FSMA 204 Critical Tracking Event in the same transaction.
- [Query EPCIS Events](https://docs.closient.com/agent-skills/query-epcis-events.md): Query the GS1 EPCIS 2.0 event ledger for the authenticated organization to reconstruct chain-of-custody for a GTIN, batch, location, or time window, returning a JSON-LD EPCISQueryDocument with cursor pagination.
- [Check FSMA 204 Readiness](https://docs.closient.com/agent-skills/check-fsma-204-readiness.md): Audit one or more GTINs for FSMA 204 (FDA Food Traceability Rule, 21 CFR § 1.1320) Key Data Element coverage by walking the captured EPCIS event ledger and the materialized Critical Tracking Event table for the authenticated organization.

### Compliance

- [US State Ingredient Disclosure](https://docs.closient.com/compliance/us-state-ingredient-disclosure.md): How Closient surfaces per-product ingredient and safety information to satisfy US state ingredient disclosure laws (Louisiana SB 14, Texas SB 25, and the copycat wave to follow), using GS1 Digital Link link types as the canonical substrate.
- [Louisiana SB 14](https://docs.closient.com/compliance/louisiana-sb14.md): Louisiana SB 14 (Act 463 of 2025) requires manufacturers of certain food products sold in Louisiana to disclose 44 listed ingredients via a scannable QR code on the package. This page covers what the statute requires, the full ingredient list, exemptions, and how to configure Closient to satisfy the…
- [Texas SB 25](https://docs.closient.com/compliance/texas-sb25.md): Texas SB 25 (89th Legislature, Regular Session, 2025) — the "Making Texas Healthy Again" act — requires manufacturers of food products offered for retail sale in Texas to disclose 44 listed ingredients via a scannable code on the package. Labeling rules take effect January 1, 2027.
- [Manufacturer Control](https://docs.closient.com/compliance/manufacturer-control.md): Why a neutral resolver — not brand-owned custom domains — is the correct architecture for satisfying "manufacturer control" requirements under US state ingredient disclosure laws (LA SB 14, TX SB 25) and the EU Digital Product Passport regime (ESPR Regulation 2024/1781).

### Concepts

- [Analytics Retention & Privacy](https://docs.closient.com/concepts/analytics-retention.md): How long Closient keeps scan analytics, what data is captured, and how privacy is preserved by design.
- [Locator Widgets — Data Processing](https://docs.closient.com/concepts/store-locator-widget-privacy.md): Every network request the embeddable store and brand locators make, what each one carries, and who receives it.

### API Reference

- [API Reference](https://docs.closient.com/api-overview.md): Explore 18 domain-specific APIs with interactive playgrounds.

### Resources

- [Changelog](https://docs.closient.com/changelog.md): Product updates, new features, and improvements to the Closient platform.

- [API Reference (300 pages)](https://docs.closient.com/_llms/api-reference.md): Documentation for API Reference.

## OpenAPI Specs

- [openapi-account](/openapi/openapi-account.json)
- [openapi-products](/openapi/openapi-products.json)
- [openapi-brands](/openapi/openapi-brands.json)
- [openapi-locations](/openapi/openapi-locations.json)
- [openapi-retailers](/openapi/openapi-retailers.json)
- [openapi-search](/openapi/openapi-search.json)
- [openapi-resolver](/openapi/openapi-resolver.json)
- [openapi-epcis](/openapi/openapi-epcis.json)
- [openapi-integrations](/openapi/openapi-integrations.json)
- [openapi-billing](/openapi/openapi-billing.json)
- [openapi-scanner](/openapi/openapi-scanner.json)
- [openapi-compliance](/openapi/openapi-compliance.json)
- [openapi-certifications](/openapi/openapi-certifications.json)
- [openapi-sustainability](/openapi/openapi-sustainability.json)
- [openapi-notifications](/openapi/openapi-notifications.json)
- [openapi-dashboard](/openapi/openapi-dashboard.json)
- [openapi-analytics](/openapi/openapi-analytics.json)
- [openapi-agent](/openapi/openapi-agent.json)
- [openapi-substances](/openapi/openapi-substances.json)
- [openapi-byos](/openapi/openapi-byos.json)
- [openapi-content](/openapi/openapi-content.json)
- [openapi-signals](/openapi/openapi-signals.json)

> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.

## Indexes

- [API Reference (300 pages)](https://docs.closient.com/_llms/api-reference.md): Documentation for API Reference.
- [API Reference / Products (55 pages)](https://docs.closient.com/_llms/api-reference/products.md): Documentation for API Reference / Products.