{"uid":"cap_T79N0Fscw82vFJZ05_KrY","slug":"sitecheck-trade-energy-upu-s10-postal-tracking-number-validator-4513deb1","name":"SiteCheck Trade & Energy – UPU S10 Postal Tracking Number Validator","description":"International postal tracking number check (UPU S10 format, e.g. RR123456785GB): validates the 8-digit serial with the S10 check digit, decodes the service type from the first letter (EMS, registered, parcel, insured...), names the origin postal country from the last two letters, and returns tracking links (origin post and multi-carrier trackers). It does not read the item's live scan history.","url":"https://api.tradeenergy-api.workers.dev/api/logistics/postal-upn-tracking?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["number"],"properties":{"number":{"type":"string","description":"S10 number: 2 letters, 9 digits, 2-letter country code, e.g. RR123456785GB"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"note":"Valid S10 number. Scan history is on the posts' tracking pages.","number":"RR123456785GB","serial":"12345678","source":"UPU S10 standard","service":"registered letter","checkedAt":"2026-10-23T09:37:58.776Z","checkDigit":5,"originCountry":"United Kingdom","trackingLinks":["https://www.royalmail.com/track-your-item#/tracking-results/RR123456785GB","https://parcelsapp.com/en/tracking/RR123456785GB"],"checkDigitValid":true,"serviceIndicator":"RR","originCountryCode":"GB","expectedCheckDigit":5}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_v_IohdjMfmJhtzsPTOD8H","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates and decodes an international postal tracking number in UPU S10 format, returning the check digit result, service type, origin country, and tracking links (without live scan history).","exampleAgentPrompt":"Can you validate the international postal tracking number RR123456785GB for me — tell me if the check digit is correct, what kind of mail service it is, which country it was sent from, and give me any tracking links?","exampleUseCases":[{"title":"Verify received parcel tracking number","prompt":"I got a tracking number from a sender abroad — RA987654321CN — can you check if it's a valid UPU S10 number, tell me what postal service type it is, what country it came from, and give me a link to track it?"},{"title":"Decode registered letter origin and type","prompt":"Can you decode the tracking number RR000123456GB for me? I want to know if it's genuine, whether it's a registered letter or parcel, and which country's postal service issued it."},{"title":"Get tracking links for e-commerce shipment","prompt":"A customer says their package tracking number is EE112233445DE — can you validate that it's a proper international postal number and pull up the tracking links so they can check delivery status?"}],"resultDescription":"Returns a JSON object with: the original number, extracted 8-digit serial, computed and expected check digits, a boolean check digit validity flag, the decoded service type (e.g. 'registered letter', 'EMS', 'parcel'), the two-letter service indicator, origin country name and ISO code, a timestamp, the data source (UPU S10 standard), tracking links to the origin postal carrier and multi-carrier trackers, and a note that live scan history is only available on the postal carriers' own tracking pages.","failureModes":["Invalid or malformed S10 number format returns an error (wrong length, missing letters, bad structure)","Unknown origin country code returns unrecognised country","Check digit mismatch returns checkDigitValid: false with both computed and expected values","Non-GET method or missing 'number' query parameter causes a 4xx error","Extremely obscure origin country codes may not resolve to a named country"],"whenToPreferThis":"Use this endpoint when you need to validate the format and check digit of a UPU S10 international postal tracking number, decode the service type (EMS, registered, parcel, insured), identify the origin country, or obtain tracking page links — without needing live delivery scan events. Prefer this over carrier-specific live tracking APIs when you only need format validation and routing information, or when the tracking number's carrier is unknown and you want to identify it from the prefix.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:34:23.402Z","isFirstParty":false,"canonicalSlug":"sitecheck-trade-energy-upu-s10-postal-tracking-number-validator-4513deb1"}