{"uid":"cap_XwjikJGS-oHrinRVEHkxX","slug":"fracht-shipment-reference-carrier-pattern-matcher-520da813","name":"Fracht Shipment Reference Carrier Pattern Matcher","description":"Matches a shipment reference against caller-supplied carrier patterns. Missing facts are returned as null and named in unavailable_fields where applicable. Derived values disclose their method; source-backed values disclose source, time window and age. ","url":"https://fracht.halowerk.com/v1/tracking-parse","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"patterns":{"type":"array","items":{"type":"object","required":["carrier","pattern"],"properties":{"carrier":{"type":"string","maxLength":512,"minLength":1,"description":""},"pattern":{"type":"string","maxLength":512,"minLength":1,"description":""}},"additionalProperties":false},"maxItems":500},"reference":{"type":"string","maxLength":100,"minLength":3,"description":""}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lI73ryapJx2MtTxwUvCB-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Matches a shipment reference string against caller-supplied carrier regex patterns to identify which carrier the reference belongs to, returning matched and unavailable fields with source and derivation metadata.","exampleAgentPrompt":"I have a shipment reference '1Z999AA10123456784' — can you match it against these carrier patterns: [{carrier: 'UPS', pattern: '1Z[A-Z0-9]{16}'}, {carrier: 'FedEx', pattern: '[0-9]{12}'}] and tell me which carrier it belongs to?","exampleUseCases":[{"title":"Automated carrier identification from tracking numbers","prompt":"I have a tracking number 'MAEU123456789' from a customer order. Can you check it against these carrier patterns — [{carrier: 'Maersk', pattern: 'MAEU[0-9]{9}'}, {carrier: 'MSC', pattern: 'MSCU[0-9]{9}'}] — and tell me which carrier it matches?"},{"title":"Logistics intake validation for mixed-carrier shipments","prompt":"We're processing a batch of inbound references and one is '176-12345678'. Match it against [{carrier: 'Air France Cargo', pattern: '176-[0-9]{8}'}, {carrier: 'Lufthansa Cargo', pattern: '020-[0-9]{8}'}] and let me know if it's a valid air waybill and which airline it belongs to."},{"title":"Custom carrier ruleset testing for freight platform","prompt":"I'm building carrier detection rules and want to test whether reference 'HLCU1234567' matches my pattern [{carrier: 'Hapag-Lloyd', pattern: 'HLCU[0-9]{7}'}] — run the parse and tell me what fields come back and which ones are unavailable."}],"resultDescription":"Returns the matched carrier name (if any pattern matches), parsed components of the shipment reference, a list of unavailable fields returned as null, derivation method for any derived values, and source, time window, and age metadata for source-backed values.","failureModes":["No pattern matches the reference — matched carrier returned as null with unavailable_fields populated","Reference string too short (under 3 chars) or too long (over 100 chars) — validation error","Invalid pattern regex syntax in caller-supplied patterns — parse error or rejection","Patterns array exceeds 500 items — request rejected","Missing required fields (reference or patterns) — 400-level error","Payment failure via x402 protocol — 402 response with payment requirements"],"whenToPreferThis":"Choose this endpoint when you need to identify a carrier from a shipment reference using your own custom carrier pattern definitions rather than a fixed registry lookup. It is ideal for freight platforms with proprietary carrier lists, multi-carrier logistics systems that need flexible pattern matching, or when testing and validating new carrier detection rules against real reference strings. Prefer this over a fixed carrier lookup when carrier patterns need to be caller-controlled and extensible.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:50:54.877Z","isFirstParty":false}