# 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 and returns precise coordinates, floor counts, elevator presence, building name, and normalized address for last-mile delivery and field operations.

## Facts

- Endpoint: POST https://telago-x402-discovery.vercel.app/geocode_address?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-267ed992
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_U07hZG1kmPqaYCNdQu1aR

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-267ed992 -d '<json body>'
```

Example prompt: Can you geocode the Korean address '서울특별시 관악구 미성3길 50' and tell me the exact coordinates, building name, how many floors it has, and whether it has an elevator?

## When to prefer this

Choose this endpoint when you need Korea-specific address geocoding enriched with building-level metadata (elevator, floor counts, building name) that generic geocoding services like Google Maps or Kakao do not reliably expose — especially for last-mile delivery, field service dispatch, or autonomous robot navigation in Korean urban environments.

## Known failure modes

- Invalid or unrecognizable Korean address returns an error or ok:false
- Address too short (under 3 characters) rejected by schema validation
- Non-Korean addresses may fail to resolve or return inaccurate results
- Payment failure via x402 protocol results in 402 response before geocoding occurs
- Ambiguous addresses (multiple matching buildings) may return the closest match without disambiguation

## 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

A JSON object with a boolean `ok` flag, the original query string, normalized Korean address, latitude and longitude coordinates, building name, number of floors above and below ground, and elevator availability (boolean).

## 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-267ed992/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)