What It Does
The Resolver API provides a public RPC that maps a product identifier to its internal product UUID. It powers the GS1 Digital Link scan path and can be called directly by external systems.Who It’s For
Systems that need to resolve a barcode or identifier to a MintID product reference without authentication.How It Works
resolve_product_alias_public
Resolves a product identifier to a product UUID using the brand’s resolver subdomain.
Required inputs:
| Parameter | Type | Description |
|---|---|---|
_resolver_subdomain | String | The brand’s resolver subdomain (e.g. acme) |
_identifier_type | String | Currently: gtin |
_identifier_value | String | The identifier to resolve (e.g. 05060012345678) |
- On match: the product UUID as a string.
- On no match:
null.
Resolution Strategy
- Active first — if the identifier is currently active on a product within the specified brand, it resolves immediately.
- History fallback — if no active match exists, the most recently retired match is returned.
- Unknown types — unrecognised identifier types return
null(fail-closed, non-throwing).
Minimal Disclosure
The resolver returns only the product UUID. No product name, description, pricing, or other data is exposed. This is by design — the resolver is a routing primitive, not a data endpoint.Limits & Notes
- Public access — no authentication is required. This RPC is callable by anyone.
- GTIN only — the resolver currently supports GTIN identifiers. EAN and UPC public entrypoints are planned for a future release.
- Digits-only normalisation — GTIN values are normalised to digits only before resolution.
- Brand-scoped — resolution is scoped to the brand identified by the resolver subdomain.
FAQ
Is product data exposed through the resolver?
Is product data exposed through the resolver?
No. Only the product UUID is returned. All product data access requires authentication via separate APIs.
What happens if a GTIN was retired?
What happens if a GTIN was retired?
The resolver falls back to the most recently retired match. Previously issued codes remain resolvable.
Can I resolve by SKU, EAN, or UPC?
Can I resolve by SKU, EAN, or UPC?
The public resolver currently supports GTIN only. SKU, EAN, and UPC public resolution is planned.