Scan & Lookup
Scan & Lookup
The Scan & Lookup module lets you verify that a Digital Product Passport is live and returning correct data. You can look up a passport by scanning a QR code, entering a GS1 Digital Link URL, a Passport UUID, or a Product SKU. Only published passports are returned.
This is the dashboard lookup tool at /dashboard/scan. It is different from the public DPP readiness scan at /scan, which is a marketing-facing tool for assessing EU DPP readiness.
Purpose
After publishing a passport and printing a label, use Scan & Lookup to confirm that the live passport record is correct before physical labels reach products. It is also used by quality and compliance teams to audit passport data on demand, and by support staff to diagnose scan failures reported by end customers.
When to Use
After publishing a passport, to confirm the live data is correct before printing labels.
After printing and applying labels, to verify the QR code resolves to the right product.
During a compliance audit, to retrieve passport data by GS1 Digital Link or Passport ID.
When a customer or retailer reports a scan failure, to reproduce and diagnose the issue.
To quickly look up a product's EU DPP score and GS1 compliance score without navigating to the passport.
Prerequisites
Only published passports are returned by the scan endpoint. A draft passport will return a "No passport found" result, even if the Passport ID or GS1 Digital Link is valid. Publish the passport before attempting a lookup.
- –At least one passport with status PUBLISHED exists in your account.
- –You have the GS1 Digital Link URL, Passport UUID, or Product SKU you want to look up.
Scanning Methods
The lookup field on /dashboard/scan accepts three types of input. The API endpoint is GET /scan?q=<query>. The system auto-detects which type of value you have entered.
A. Scanning a QR Code with Your Phone
PassportBox QR labels encode a GS1 Digital Link URL. Your phone camera can read it directly — no dedicated scanner app is required. The URL that the camera surfaces is the value to paste into the lookup field.
- 1.Open your phone's default camera app and point it at the QR code on the label.
- 2.A banner or notification appears with the GS1 Digital Link URL (starts with https://id.gs1.org/).
- 3.Tap the banner to confirm the URL, then copy it from the browser address bar.
- 4.Return to the PassportBox dashboard on your computer and open Scan & Lookup.
- 5.Paste the URL into the search field and click Scan.
B. Entering a GS1 Digital Link
If you have the GS1 Digital Link URL from the passport detail page or from a printed label, paste it directly. The expected format is:
https://id.gs1.org/01/{GTIN}- 1.Copy the GS1 Digital Link from the passport's detail page (visible after publishing) or from a previous label.
- 2.Open Scan & Lookup at /dashboard/scan.
- 3.Paste the URL into the search field.
- 4.Click Scan. Results appear below the input.
C. Entering a Passport ID or Product SKU
If you have the passport's UUID (shown in the passport detail URL and in API responses) or the product's SKU, you can use either as the lookup query. UUID format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
- 1.Locate the Passport UUID from the passport detail page URL or from the API.
- 2.Alternatively, use the Product SKU as shown in the Products module.
- 3.Open Scan & Lookup at /dashboard/scan.
- 4.Type or paste the UUID or SKU into the search field.
- 5.Click Scan. The system matches against published passports only.
Understanding Scan Results
When a passport is found, a green Passport Found badge appears at the top of the result card. The following fields are displayed:
| Field | Description |
|---|---|
| Passport name | The name you assigned when creating the passport. |
| Product name | The product this passport is linked to. |
| Status | Always PUBLISHED for results returned here. |
| Manufacturer | The supplier or manufacturer on record for this product. |
| Materials | The materials list entered in the passport, including percentages where provided. |
| Sustainability data | Any sustainability attributes recorded: recycled content, carbon footprint, certifications. |
| EU DPP score | Percentage score reflecting compliance with EU ESPR Digital Product Passport requirements. |
| GS1 score | Percentage score reflecting GS1 Digital Link and data quality standards. |
Compliance Score Interpretation
Both scores range from 0% to 100%. Higher is better.
EU DPP Score
Measures how completely your passport satisfies the EU ESPR (Ecodesign for Sustainable Products Regulation) Digital Product Passport requirements. The score is calculated against the mandatory and recommended data fields defined in the ESPR framework.
90 – 100%Fully compliant70 – 89%Mostly compliant — minor fields missing50 – 69%Partially compliant — significant gaps0 – 49%Non-compliant — substantial data missingGS1 Score
Measures the quality and completeness of the GS1 Digital Link implementation: GTIN presence, resolver configuration, link targets, and data quality attributes. A high GS1 score means the QR label will resolve reliably across all GS1-compliant scanners and retail ecosystems.
90 – 100%Full GS1 Digital Link compliance70 – 89%Resolver works; optional attributes missing50 – 69%Resolver issues likely in some ecosystems0 – 49%Critical GS1 data missing; label may not resolveWhen No Passport is Found
If the lookup returns no result, a red No passport found error is displayed. Common causes:
Passport is still in draft status
Draft passports are not visible to the scan endpoint. Publish the passport and retry.
Wrong Passport ID or GS1 link
Double-check the UUID or URL. A single character mismatch returns no result.
Passport was unpublished after the label was printed
If a passport is reverted to draft, scans will return not-found even for existing labels. Re-publish to restore visibility.
The SKU does not match any published passport
SKU lookup is exact-match. Check for trailing spaces, case differences, or leading zeros.
Validation Rules and Edge Cases
Empty query submitted
The Scan button is disabled until at least one character is entered.
GS1 Digital Link with invalid GTIN structure
The API returns a schema validation error. Ensure the URL follows the format https://id.gs1.org/01/{GTIN} with a valid 8, 12, 13, or 14-digit GTIN.
Draft passport UUID entered
Returns "No passport found" — identical to a non-existent ID. This is intentional to avoid leaking draft data.
UUID from a different organization's passport
The scan endpoint returns public data only. Published passports from other organizations on PassportBox are visible if their GS1 link is known.
Multiple passports share the same product SKU
All published passports for that SKU are returned, ordered by publish date descending. The most recently published passport appears first.
GS1 Digital Link with additional path segments
Extended links (e.g., /10/batch/21/serial) are accepted. The resolver extracts the GTIN from the 01 segment.
What Success Looks Like
A green "Passport Found" badge appears at the top of the result card.
The passport name and product name match what you entered when creating the passport.
Manufacturer, materials, and sustainability data are correct and complete.
Both the EU DPP score and the GS1 score are at 70% or above (ideally 90%+).
Scanning the physical QR label with a phone camera returns the same GS1 Digital Link you entered here.
Troubleshooting
Scan returns "No passport found" for a passport I just published
Allow up to 30 seconds for the GS1 Digital Link to propagate. If the issue persists after a minute, check that the passport status badge shows PUBLISHED (not PENDING PUBLISH). Contact support if the badge is stuck.
Phone camera reads the QR code but opens a 404 page
The passport associated with that QR code may have been unpublished. Use Scan & Lookup to confirm the passport status. If it is in draft, re-publish it from the Passports module.
GS1 Digital Link URL entered correctly but returns schema error
Verify the GTIN segment: the value after "/01/" must be a numeric GTIN (8, 12, 13, or 14 digits). GTINs with check-digit errors or non-numeric characters are rejected.
Compliance scores are lower than expected
Open the passport in the Passports module and check for incomplete required fields. The passport editor highlights missing mandatory fields with a warning indicator. Fill in the missing data and re-publish; scores update immediately on the next scan.
Scan works in the dashboard but the public GS1 link returns an error
The dashboard scan reads from the PassportBox database directly. The public GS1 resolver is a separate service. If public resolution fails, check the GS1 resolver configuration in your account settings or contact support to verify GTIN registration.
Related Links
External reference: GS1 Digital Link standard
Scan events are logged for analytics
Every lookup made through the dashboard scan endpoint is recorded as a scan event. You can view scan history, geographic distribution, and frequency in the Analytics module.