CircularID Docs← Back to Dashboard
MOBILE APPS

Show passports in your app

Two options depending on how much native UI you want: open the public passport page, or pull the data and render it natively.

Option A — WebView (fastest)

Every published passport has a permanent public URL: https://circularid.trikagency.com/passport/{id}. Open it in a WebView (or an in-app browser tab) when a customer scans the garment's QR code or taps “View Passport” in your app. It's the same page a browser scan of the QR code lands on — fully responsive, no app-specific work needed on our end.

Option B — native UI via the API

If you want the passport data rendered with your own native components, generate a Developer API Key (Settings → Integrations → Developer in CircularID) and call the same public endpoints your web app uses. See the API reference for the full endpoint list and response shapes — the data is JSON either way, WebView or native.

Resolving a scanned QR code

The QR code on a physical product already encodes the full public passport URL (or its GS1 Digital Link form if the product has a GTIN, e.g. /01/{gtin}/21/{batch}). Your app doesn't need to do any lookup — just open whatever URL the QR code contains.