{"uid":"cap_i-e6cgotkF-x9BlOwz8yF","slug":"fracht-halowerk-com-un-locode-resolver-8e10a04d","name":"fracht.halowerk.com UN/LOCODE Resolver","description":"Resolves a UN/LOCODE against a supplied official code-list record. 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/locode-resolve","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"locode":{"type":"string","pattern":"^[A-Za-z]{2}[A-Za-z0-9]{3}$"},"source":{"type":"object","required":["url","published_at","title"],"properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string","maxLength":300,"minLength":3,"description":""},"published_at":{"type":"string","format":"date-time"}},"additionalProperties":false},"records":{"type":"array","items":{"type":"object","required":["locode","name","subdivision","functions","coordinates"],"properties":{"name":{"type":"string","maxLength":512,"minLength":1,"description":""},"locode":{"type":"string","maxLength":5,"minLength":5,"description":""},"functions":{"type":"string","maxLength":20,"minLength":0,"description":""},"coordinates":{"type":"string","maxLength":20,"minLength":0,"description":""},"subdivision":{"type":"string","maxLength":20,"minLength":0,"description":""}},"additionalProperties":false},"maxItems":10000}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_15Qi4d1grOFL_9RS7Doy2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a UN/LOCODE code against a supplied official code-list record, returning enriched location facts, derived values with methodology disclosures, and null placeholders with field names for missing data.","exampleAgentPrompt":"Can you resolve the UN/LOCODE DEHAM against this official code-list record — it covers Hamburg, Germany, with functions '12345---' and coordinates '5332N 00959E', published at https://unece.org/trade/cefact/UNLOCODE-Download2023.html on 2023-01-15T00:00:00Z?","exampleUseCases":[{"title":"Port identification for freight booking","prompt":"I need to resolve the UN/LOCODE NLRTM — that's Rotterdam in the Netherlands — against the official UNECE 2023 code list record. The source URL is https://unece.org/locode2023, published 2023-01-15T00:00:00Z. Can you tell me the full name, subdivision, functions, and coordinates, and flag any missing fields?"},{"title":"Validating shipper-submitted location codes","prompt":"A shipper gave us the LOCODE CNSHA for Shanghai. Can you resolve it against this official record — name 'Shanghai', subdivision 'SH', functions '12345---', coordinates '3114N 12129E', from https://unece.org/locode2023 published 2023-01-15T00:00:00Z — and let me know if anything's unavailable or derived?"},{"title":"Enriching customs declaration with LOCODE data","prompt":"I'm filling out a customs declaration and need enriched details for the LOCODE GBFXT. Can you resolve it against the official code-list entry — title 'UNECE LOCODE 2023-2', URL https://unece.org/locode2023, published 2023-06-01T00:00:00Z — and tell me which fields are missing and how any derived values were calculated?"}],"resultDescription":"Returns a structured object containing resolved location facts (name, subdivision, functions, coordinates) for the given UN/LOCODE, with derived values annotated with their derivation method, source-backed values annotated with source URL, time window, and data age, and any unavailable fields listed by name with null values.","failureModes":["Invalid LOCODE format (not matching 2-letter country + 3 alphanumeric) returns validation error","Missing required source fields (url, published_at, title) causes request rejection","Empty or malformed records array may result in unresolvable LOCODE with all fields returned as null","Source URL unreachable or unparseable may degrade provenance disclosures","LOCODE not found in supplied records returns all facts as null with full unavailable_fields list"],"whenToPreferThis":"Choose this endpoint when you need to resolve, validate, or enrich a specific UN/LOCODE against a known official code-list record and require transparent provenance — including which fields are derived vs. source-backed and how derived values were computed. It is especially suited for logistics, customs, and supply-chain workflows where auditability and null-field transparency matter more than simple code lookups.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:34:59.205Z","isFirstParty":false}