{"uid":"cap_XecI9_ERfJJWbEnnuYWkZ","slug":"sitecheck-trade-energy-un-locode-location-lookup-18836fb1","name":"SiteCheck Trade & Energy – UN/LOCODE Location Lookup","description":"UN/LOCODE location lookup by 5-character code (country + place, e.g. FIHEL): name, subdivision, status, port/rail/road/airport functions, IATA code and coordinates. Data is the UN/LOCODE list as mirrored on DataHub (ODC-PDDL), not the UNECE site itself.","url":"https://api.tradeenergy-api.workers.dev/api/logistics/seaport-unlocode?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":["code"],"properties":{"code":{"type":"string","description":"UN/LOCODE, 5 letters: 2-letter country + 3-character location, e.g. FIHEL, SGSIN"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"code":"FIHEL","iata":null,"name":"Helsinki","source":"https://datahub.io/core/un-locode/r/code-list.csv","status":"AS","country":"FI","checkedAt":"2026-10-23T09:37:58.254Z","functions":["port","road terminal"],"coordinates":{"lat":60.1667,"lon":24.9333},"subdivision":"18"}},"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_lMTocNnpvrfyBWEQ493Gc","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":"Returns structured location data (name, subdivision, functions, coordinates, IATA code) for a 5-character UN/LOCODE code","exampleAgentPrompt":"Can you look up the UN/LOCODE SGSIN for me and tell me the city name, its transport functions (port, rail, road, airport), and its GPS coordinates?","exampleUseCases":[{"title":"Enrich shipment records with location data","prompt":"I have a list of UN/LOCODEs from our shipping manifests — start with DEHAM. Look it up and tell me the city name, what transport modes it supports, and its coordinates so I can enrich our logistics database."},{"title":"Verify port functions before routing cargo","prompt":"Before we route this container, can you check UN/LOCODE NLRTM and confirm whether it's designated as a port and road terminal, and give me its subdivision and status?"},{"title":"Resolve LOCODE to map coordinates","prompt":"I need the latitude and longitude for the trade location with UN/LOCODE CNSHA so I can plot it on a map."}],"resultDescription":"A JSON object with the resolved location's full name, 2-letter country code, subdivision code, status indicator (e.g. 'AS' for approved by member state), list of transport functions (e.g. port, road terminal, rail terminal, airport), IATA code if available, WGS-84 coordinates (lat/lon), the data source URL, and a timestamp of when the record was checked.","failureModes":["Unknown or invalid LOCODE returns a 404 or empty result","Malformed code (not exactly 5 alphanumeric characters) returns a validation error","Coordinates may be null for landlocked or less-documented locations","IATA code field may be null if no IATA mapping exists","Data reflects the DataHub mirror of UN/LOCODE, which may lag behind the latest UNECE publication"],"whenToPreferThis":"Use this endpoint when you need to decode or validate a 5-character UN/LOCODE into human-readable location metadata, transport mode flags, and coordinates. Prefer it over raw UNECE lookups because it returns a clean JSON response with structured fields. Ideal for enriching logistics data pipelines, validating shipping documents, or resolving trade location codes to map coordinates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:32:58.672Z","isFirstParty":false,"canonicalSlug":"sitecheck-trade-energy-un-locode-location-lookup-18836fb1"}