# TELAGO Korea Address Geocoding API

> TELAGO Korea Address Geocoding API is a paid API for AI agents from telago-x402-discovery.vercel.app, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-17).

Geocodes a Korean address string to coordinates and returns building metadata including elevator access, floor counts, and normalized address.

## Facts

- Endpoint: POST https://telago-x402-discovery.vercel.app/geocode?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/telago-korea-address-geocoding-api-bf5eab80
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vdxh8R-AgRmuVUZ0yL-t8

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 telago-korea-address-geocoding-api-bf5eab80 -d '<json body>'
```

Example prompt: Can you look up the coordinates and building details — like whether there's an elevator and how many floors — for this Korean address: 서울특별시 관악구 미성3길 50?

## When to prefer this

Choose this endpoint when you need Korea-specific address geocoding with building-level metadata (elevator, floor counts, building name) beyond what generic geocoders provide — especially for robotics, last-mile delivery, field service dispatch, or any workflow that needs to know physical building access characteristics in Korea.

## Known failure modes

- Address not found or unrecognizable — returns ok:false or error message
- Address string too short (under 3 chars) or too long (over 300 chars) — validation error
- Non-Korean address submitted — may return no results or low-confidence match
- Payment failure via x402 protocol — 402 response before geocoding is attempted
- Service unavailable on Vercel deployment — 500 or timeout error

## How this service works

Pay-per-call Korea execution intelligence for AI agents: address geocoding, building access, last-meter delivery, field service, robotics and cross-border logistics.

## Output

Returns a JSON object with ok status, the original query, latitude, longitude, building name, normalized Korean address, elevator availability (boolean), floors above ground, and floors below ground.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "maxLength": 300,
   "minLength": 3
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "query": "서울특별시 관악구 미성3길 50",
  "elevator": true,
  "latitude": 37.4725288710309,
  "longitude": 126.917605285307,
  "floorsAbove": 6,
  "floorsBelow": 0,
  "buildingName": "다숲",
  "normalizedAddress": "서울특별시 관악구 미성3길 50"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/telago-korea-address-geocoding-api-bf5eab80/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from telago-x402-discovery.vercel.app](https://www.zero.xyz/host/telago-x402-discovery.vercel.app/llms.txt)