# gateway.apiosk.com Address Cleaner

> gateway.apiosk.com Address Cleaner is a paid API for AI agents from gateway.apiosk.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Parses and standardizes a raw postal address string into structured components (street, number, city, postcode) and validates it

## Facts

- Endpoint: POST https://gateway.apiosk.com/data-clean/clean/address
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gateway-apiosk-com-address-cleaner-308e5e7b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2v2qnxFfoN5RU25aGHnKm

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 gateway-apiosk-com-address-cleaner-308e5e7b -d '<json body>'
```

Example prompt: Can you clean and validate this address for me — 'Keizersgracht 123, Amsterdam' in the Netherlands — and tell me if it's a valid address and what the correct postcode is?

## When to prefer this

Use this endpoint when you need to validate, parse, and standardize a freeform postal address string into structured components before storing or shipping. Ideal for e-commerce checkout flows, CRM data cleaning, or logistics pipelines where structured address fields (street, number, city, postcode) are required and you need a validity flag. Prefer this over geocoding APIs when you need clean postal structure rather than lat/lng coordinates.

## Known failure modes

- Address not found or unrecognizable — valid:false returned
- Missing required address field — may return ok:false or partial result
- Invalid or unsupported country code — may return error or empty fields
- Ambiguous address with multiple matches — may return best guess or fail
- Network timeout or service unavailability — HTTP 5xx error

## How this service works

Parse common EU address strings into street, number, postcode and city, with postcode syntax validation per country.

## Output

Returns a JSON object with ok (boolean), valid (boolean), and parsed address fields: street, number, city, and postcode. For example: {ok: true, valid: true, street: 'Keizersgracht', number: '123', city: 'Amsterdam', postcode: '1015 CJ'}.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gateway-apiosk-com-address-cleaner-308e5e7b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.apiosk.com](https://www.zero.xyz/host/gateway.apiosk.com/llms.txt)