{"uid":"cap_yqAsHuMvjE1Cgl7p1UV-O","slug":"eckari-parcel-carrier-detector-abfed338","name":"Eckari Parcel Carrier Detector","description":"Identify which carrier issued a tracking number using a deterministic, versioned signature set - prefixes, lengths, carrier check digits and UPU S10 structure - returning the carrier, how distinctive the match is, every ranked candidate with typed evidence, and the parsed S10 details. No upstream call and no carrier account required. Use when: Which carrier is this tracking number from?","url":"https://api.eckari.com/v1/parcels/detect-carrier?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["tracking_number"],"properties":{"origin_country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Optional ISO 3166-1 alpha-2 origin country hint. Used only as a small tie-breaker; it never invents a candidate."},"tracking_number":{"type":"string","pattern":"^[A-Za-z0-9 -]+$","maxLength":60,"minLength":4,"description":"Tracking or consignment number. Spaces and hyphens are removed and letters upper-cased before matching (4-40 letters and digits after normalisation). Digits and letters are never altered."},"destination_country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Optional ISO 3166-1 alpha-2 destination country hint. Used only as a small tie-breaker; it never invents a candidate."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"input":{"original":"1Z 879E93 03 4683 4440","normalised":"1Z879E930346834440"},"carrier":{"id":"ups","name":"UPS"},"upu_s10":null,"candidates":[{"evidence":{"length":18,"prefix":"1Z","check_digit":"ups_mod10","country_hint":null,"s10_origin_country":null},"format_id":"ups_1z","carrier_id":"ups","match_score":0.98,"carrier_name":"UPS","match_strength":"distinctive"}],"match_score":0.98,"match_strength":"distinctive","formats_matched":1,"signature_version":"1.1.0"},"meta":{"source":"eckari_carrier_signatures","version":"2.0.0","freshness":"static","capability":"parcel.detect_carrier"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hgn9PYZwuhMtH8sYUZddr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Identifies which carrier issued a given tracking number using deterministic signature matching (prefixes, lengths, check digits, UPU S10 structure) without any upstream carrier API calls.","exampleAgentPrompt":"Which carrier issued the tracking number '1Z 879E93 03 4683 4440'? I need to know who to contact about this shipment.","exampleUseCases":[{"title":"Identify carrier for customer support","prompt":"A customer gave me tracking number RB123456785GB — can you figure out which carrier that belongs to so I know who to escalate their missing parcel to?"},{"title":"Auto-route shipment tracking in e-commerce","prompt":"I have a batch of tracking numbers coming in from my store orders — start with JD014600004867512345 and tell me which carrier it belongs to and how confident you are in the match."},{"title":"Validate tracking number before filing a claim","prompt":"Before I file a lost parcel claim, can you check whether the tracking number LP123456789DE is actually a valid DHL format or if the customer gave me something garbled?"}],"resultDescription":"Returns the identified carrier (ID and name), a match score (0–1), match strength label (e.g. 'distinctive'), a ranked list of all candidate carriers with typed evidence per candidate (prefix matched, length, check digit type, country hints), parsed UPU S10 fields if applicable, and metadata including the signature version used. No network call to any carrier is made.","failureModes":["Tracking number too short (under 4 chars after normalisation) — returns 400 validation error","Tracking number contains invalid characters — rejected by pattern validation","Ambiguous tracking number matching multiple carriers — returns multiple candidates with lower match scores rather than a single definitive answer","Unknown or proprietary carrier format not in signature set — returns empty candidates list or low-confidence match","Origin/destination country codes in wrong format — 400 if not valid ISO 3166-1 alpha-2"],"whenToPreferThis":"Choose this endpoint when you need fast, offline carrier identification with no carrier account or API key — especially when you want a confidence score and ranked candidate evidence rather than a simple guess. Prefer it over scraping carrier websites or calling carrier tracking APIs just to identify the carrier. Ideal for routing logic, customer support automation, or pre-validating tracking numbers before calling a carrier's own tracking API.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:31:53.941Z","isFirstParty":false,"canonicalSlug":"eckari-parcel-carrier-detector-abfed338"}