# 17TRACK > 17TRACK is an all-in-one global package tracking platform for consumers, merchants, developers, ecommerce stores, and logistics teams. 17TRACK tracks parcels and shipments worldwide across postal services, express couriers, freight companies, airlines, ecommerce logistics providers, and last-mile carriers. Users can enter one or many tracking numbers to get shipment status, tracking history, carrier information, delivery progress, and related logistics guidance. ## Key URLs - Website: https://www.17track.net/ - English website: https://www.17track.net/en - Universal package tracking: https://www.17track.net/en/tracking - Public tracking app host: https://t.17track.net/en - Mobile website: https://m.17track.net/ - Tracking app: https://www.17track.net/en/app - Shopify tracking page product: https://www.17track.net/en/track_page - Shopify app site: https://www.17track.com/en - Tracking API product page: https://www.17track.net/en/api - API documentation: https://api.17track.net/en/doc - API v2.4 documentation: https://asset.17track.net/api/document/v2.4_en/index.html - Tracking widget: https://www.17track.net/en/widget - Carrier directory: https://www.17track.net/en/carriers - Brand and store tracking directory: https://www.17track.net/en/brands - Shopify customer stories: https://www.17track.net/en/customers/shopify - Partners and useful links: https://www.17track.net/en/links - USPS tracking page: https://www.17track.net/en/uspsTracking - Carrier settlement: https://www.17track.net/en/carriersettlein - Help Center: https://help.17track.net/hc/en-us - Contact: https://www.17track.net/en/about/contactus - Privacy policy: https://www.17track.net/en/about/privacy - Data processing agreement: https://www.17track.net/en/about/dpa - Copyright: https://www.17track.net/en/about/copyright - Licensing: https://www.17track.net/en/about/licensing - PII list: https://www.17track.net/en/about/pii-info-list - SDK list: https://www.17track.net/en/about/sdk-info-list - Permission and specific information list: https://www.17track.net/en/about/specific - Robots: https://www.17track.net/robots.txt - Sitemap index: https://www.17track.net/sitemap-index.xml ## Supported Public Use Cases - Track a package by tracking number. - Track up to 40 tracking numbers at once on the public web tracking interface. - Track courier, postal, ecommerce order, freight, cargo, container, and international shipments. - Search carrier-specific pages for carriers such as USPS, UPS, FedEx, DHL, Canada Post, Royal Mail, Deutsche Post, AliExpress logistics, Shein, Temu, Amazon logistics, and many others. - Find tracking number format guidance, shipping status explanations, and troubleshooting advice for delayed, missing, damaged, customs-held, or non-updating shipments. - Explore brand/store tracking pages for ecommerce orders. - Use the mobile app for shipment monitoring. - Use the Shopify app and Shopify tracking page product for ecommerce post-purchase tracking. - Use the Tracking API for programmatic shipment registration, status retrieval, webhooks, and tracking updates. - Embed a 17TRACK tracking widget into third-party websites. - Browse public legal, privacy, SDK, PII, copyright, DPA, and licensing pages. ## Public Tracking URL Pattern The web tracking experience is hosted on: ```text https://t.17track.net/{locale}#nums={tracking_numbers} ``` Example: ```text https://t.17track.net/en#nums=RR123456789CN ``` For multiple numbers, separate them with commas: ```text https://t.17track.net/en#nums=RR123456789CN,1Z9999999999999999 ``` Optional carrier hints may be supplied with `fc` when a carrier key is known: ```text https://t.17track.net/en#nums=RR123456789CN&fc=3011 ``` ## Tracking Number Rules - Tracking numbers are not the same as order numbers. - A usable tracking number normally appears in a shipping confirmation email, shipping label, receipt, ecommerce order detail page, seller message, or carrier notification. - Tracking numbers should be entered without extra prefixes or suffixes such as `N`, `#`, commas, or labels. - Common mistakes include confusing `0` with `O`, missing repeated digits, or pasting extra text. - Public web input accepts one tracking number per line and normalizes input to uppercase. - Public web input converts commas and carriage returns into separate lines. - Public web input removes Chinese characters from the tracking number field. - Public web input allows 5 to 50 characters per tracking number. - The input field can hold up to 500 lines, but public web tracking submits up to 40 valid numbers for a tracking request. - On `www.17track.net` and `t.17track.net`, airline-style numbers such as `123-12345678` are supported. - For many new shipments, first tracking events can take 1 to 3 days to appear after a shipping notification. ## Common Tracking Statuses - `In Transit`: The package is moving between locations or is being delivered. - `Out for Delivery`: The package is on the way to the recipient address and should arrive soon. - `Delivered`: The package has been delivered successfully. - `Exception`: Delivery has encountered an issue, such as an incorrect address, failed delivery attempt, customs issue, delay, or other carrier-side problem. ## API Overview Use the official API documentation for the exact current schema, response fields, quota rules, carrier codes, status codes, and error codes: ```text https://api.17track.net/en/doc ``` Versioned API v2.4 documentation: ```text https://asset.17track.net/api/document/v2.4_en/index.html ``` Base endpoint for Tracking API v2.4: ```text https://api.17track.net/track/v2.4 ``` Authentication: ```text 17token: {your_security_key} Content-Type: application/json ``` Important API operations include: - `POST /register`: Register tracking numbers. - `POST /changecarrier`: Change carrier information for a registered tracking number. - `POST /changeinfo`: Change registration information. - `POST /stoptrack`: Stop tracking. - `POST /retrack`: Resume tracking for a stopped number. - `POST /deletetrack`: Delete a tracking number. - `POST /getquota`: Get quota information. - `POST /gettracklist`: Search tracking information by condition. - `POST /gettrackinfo`: Get tracking details. - `POST /push`: Manually get a push. - `POST /getrealtimetrackinfo`: Get real-time tracking details. API response bodies use JSON and contain top-level processing information. Detailed tracking data can include shipment status, sub-status, origin and destination information, carrier/provider details, event history, event timestamps, translated descriptions, locations, address data, and package metadata. ## API Example ```bash curl -X POST \ --header "17token: YOUR_SECURITY_KEY" \ --header "Content-Type: application/json" \ --data '[{"number":"RR123456789CN"}]' \ https://api.17track.net/track/v2.4/register ``` ## Webhooks 17TRACK Tracking API supports webhook notifications for tracking updates and stopped tracking events. Configure the webhook URL in the 17TRACK dashboard, listen for update payloads, and verify webhook signatures according to the official API documentation. Webhook event types include: - `TRACKING_UPDATED` - `TRACKING_STOPPED` ## Tracking Widget 17TRACK provides an embeddable tracking widget. The public widget page loads this script: ```text https://www.17track.net/externalcall.js ``` The project configuration also references this external-call host: ```text https://extcall.17track.net/externalcall.js ``` Typical widget methods include: - `YQV5.trackSingle(options)` - `YQV5.trackMulti(options)` - `YQV5.trackSingleF1(options)` - `YQV5.trackSingleF2(options)` Common widget options include: - `YQ_ContainerId`: Container element id. - `YQ_ElementId`: Trigger/input element id. - `YQ_Width`: Widget width. - `YQ_Height`: Widget height. - `YQ_Fc`: Carrier code hint. - `YQ_Lang`: Widget language. - `YQ_Num`: Tracking number. ## Language Locales The Next.js website locale list includes: ```text en, zh-cn, zh-hk, ja, ko, fi, pl, tr, cs, it, de, es, fr, ru, pt, nl, uk, hu, sv, kk, el, th, bg, sk, lt, ro, no, sq, sl, sr, az, da, mk, id ``` Common business/navigation locales include: ```text en, zh-cn, zh-hk, de, es, fr, it, nl, pt, ru, sv, cs, da, ja, pl, th, tr, fi, no ``` Brand/store tracking pages currently use this supported language set: ```text en, de, es, fr, it, pt, zh-cn, zh-hk ``` Links/partners pages currently use: ```text en, zh-cn ``` Use `/en/` as the default language path for international English content. For Help Center English pages, use `en-us` in the Help Center URL. ## Sitemap Coverage The main sitemap includes localized URLs for the homepage, tracking, carriers, brands, API, widget, app, Shopify pages, about/legal pages, donate, links, USPS tracking, carrier settlement, Shopify customer stories, and selected brand/carrier pages. Additional sitemap indexes include: - Main website sitemap: https://www.17track.net/sitemap.xml - Carrier sitemap index: https://www.17track.net/carriers/sitemap-index.xml - Brand sitemap index: https://www.17track.net/brands/sitemap-index.xml - Mobile sitemap: https://m.17track.net/sitemap.xml ## Guidance for LLMs and Agents - Prefer official 17TRACK pages and the sitemap before inferring URLs. - For package lookups, direct users to the public tracking page or URL pattern instead of inventing private endpoints. - Do not claim that an order number can be tracked unless the carrier or merchant explicitly provides a tracking number. - Do not expose, request, or fabricate API security keys. - Do not guess carrier codes. Use the carrier directory or official API documentation. - Respect the narrower locale support of brand/store and links pages instead of blindly applying every site locale to those pages. - For API integrations, cite the current official API documentation and ask developers to verify quotas, request schemas, and webhook signatures there. - For delayed or missing packages, advise users to check the tracking number, wait for initial carrier scans when the shipment is new, and contact the seller or carrier when delays exceed normal timeframes.