# fracht.halowerk.com UN/LOCODE Resolver

> fracht.halowerk.com UN/LOCODE Resolver is a paid API for AI agents from fracht.halowerk.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

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.

## Facts

- Endpoint: POST https://fracht.halowerk.com/v1/locode-resolve
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fracht-halowerk-com-un-locode-resolver-8e10a04d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_i-e6cgotkF-x9BlOwz8yF

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability fracht-halowerk-com-un-locode-resolver-8e10a04d -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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. 

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fracht-halowerk-com-un-locode-resolver-8e10a04d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fracht.halowerk.com](https://www.zero.xyz/host/fracht.halowerk.com/llms.txt)