{"uid":"cap_N_-GCRodSVcGjqo0XZEcp","slug":"fracht-bill-of-lading-air-waybill-reference-parser-f929bec3","name":"Fracht Bill-of-Lading & Air-Waybill Reference Parser","description":"Separates common bill-of-lading and air-waybill reference components. 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/bl-parse","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"kind":{"enum":["auto","bl","awb"],"type":"string"},"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_zhm8g6qMF-EFAY4eYjQTJ","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":"Parses and separates structured components from bill-of-lading (BL) or air-waybill (AWB) reference strings, returning null for missing fields and disclosing derivation methods for inferred values.","exampleAgentPrompt":"Can you parse this bill of lading reference for me — MAEU123456789 — and break out all the components like carrier, serial number, and check digit? Auto-detect whether it's a BL or AWB.","exampleUseCases":[{"title":"Carrier extraction from BL number","prompt":"I have a bill of lading number HLCU3001234567 — can you parse it and tell me the carrier prefix, serial number, and any other components it contains?"},{"title":"Auto-detect and parse AWB reference","prompt":"I'm not sure if this is a bill of lading or an air waybill: 176-12345678. Can you auto-detect the type and extract all the structured fields from it?"},{"title":"Identify missing fields in shipment reference","prompt":"Parse this shipping reference 'OOLU7654321' and tell me which fields could be extracted and which ones are unavailable or missing."}],"resultDescription":"A structured breakdown of the reference string into its recognized components (e.g. carrier prefix, serial number, check digit, document type), with null values and an unavailable_fields list for anything that could not be resolved, plus disclosure of derivation method and source/time-window metadata for inferred or source-backed values.","failureModes":["Reference string too short (below 3 characters) or too long (above 100 characters) — validation error","Unrecognized or malformed reference format — components returned as null with all fields in unavailable_fields","Ambiguous reference when kind=auto cannot determine document type — type field may be null","Empty or missing reference field — request rejected with schema validation error"],"whenToPreferThis":"Use this endpoint when you need to programmatically decompose a raw BL or AWB reference string into structured fields, especially when the document type is uncertain and auto-detection is needed. Prefer it over generic regex parsing when transparency about derivation method and missing-field disclosure is important for downstream logistics workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:44:45.071Z","isFirstParty":false}