For partners: the address model

A partner gets four things from dock: a code, the official line, a level, and a route that ends at the gate. This page shows them with three real codes. It has no prices and no offers.

The code

Every registered building and every хашаа (ger plot) has a 5-character code. The code points to the door. A code that was issued is never issued again. One door has two forms:

• Spoken: Сансар А 8. GET /v1/geocode finds it.
• Typed: 7QSVX. GET /v1/door/7QSVX reads it.

The official line

Behind every code stands the state's official address. The line is in Cyrillic: district, khoroo, street, building or хашаа, and the postal code when the register has one. A match with the state register is official_status: "matched" (бүртгэлтэй). A partial match is partial (хэсэгчилсэн). No match is none (албан бус). Unless it is matched, the answer says "unofficial": true, and you show "unofficial".

Code	Kind	Official line (official_line)
7QSVX	building	Баянзүрх дүүрэг, 3-р хороо, Сансар, 8-р байр · 13381-0034
BS5SS	building	Сүхбаатар дүүрэг, 6-р хороо, Сүхбаатарын талбай, 1-р байр · 14201-0047
ZR2Q8	хашаа	Чингэлтэй дүүрэг, 10-р хороо, Чингэлтэй гудамж-7, 196-р хашаа

The ZR2Q8 line has no postal code: the register gives none, so we add none. The three lines are from real GET /v1/door/{code} answers (/api-examples.json, 2026-10-20).

Levels

Rows of geocode and nearby, and each door, can carry a trust level (confidence, 0 to 4). null means unknown. We do not make a level up.

Level	Meaning
0	placed by rule (автоматаар байрлуулсан)
1	checked against imagery (зурагтай тулгаж шалгасан)
2	confirmed once on site (газар дээр нэг удаа баталсан)
3	confirmed independently three times (бие даан гурван удаа баталсан)
4	surveyed (хэмжилтээр баталсан)

Явах (go) ends at the gate

GET /v1/route?from=...&to=7QSVX resolves the code to the street side of the building, or to the gate of a yard. The route ends at the gate; where the map has no gate, at the wall or fence facing the street. It never ends in the middle of the building. When the last walk is over 15 m, the last step says to leave the car ("Машинаа тавиад 17 м алхана уу."). The arrival says "Хаалга зүүн талд байна". Each step has Mongolian and English text, and signal marks a traffic light. The walk left after the road network ends is not drawn as road; it is given in metres as to.gap_m.

Call it

Reading a code, and routing to one, needs the door:read scope.

curl -H "Authorization: Bearer $DOCK_KEY" \
  "https://geo.dock.mn/v1/door/7QSVX"

The full answer and every field: API reference. The source and the date of an address are in official_source and official_date on each answer.