Адрес по коду

Все поля адреса по его коду в ГАР: id, GUID или коду КЛАДР. До 100 адресов одним запросом — например, чтобы обновить адреса в своей базе.

GETPOSThttps://api.adresnitsa.ru/v1/details

Нужен секретный ключ: этот маршрут работает только с сервера.

Параметры

Передайте один из параметров.

Параметр	Тип	Что это
id	целое	Код объекта в ГАР (OBJECTID): поле `id` из поиска.
guid	строка	GUID объекта в ГАР (OBJECTGUID): поле `guid` из поиска.
kladr	строка	Код КЛАДР. Возвращает до 100 объектов с этим кодом.
ids	список, до 100	Несколько id. В GET — через запятую, в POST — массив.
guids	список, до 100	Несколько GUID, так же.

Код, которого нет в ГАР, не ошибка: он вернётся в notFound. Если запрошен один код и его нет, ответ — 404 not_found.

По id

curl

curl -G https://api.adresnitsa.ru/v1/details \
  -H "Authorization: Token ВАШ_КЛЮЧ" \
  -d id=26847188

JavaScript

const url = new URL("https://api.adresnitsa.ru/v1/details");
url.search = new URLSearchParams({ id: "26847188" });
const res = await fetch(url, {
  headers: { Authorization: "Token ВАШ_КЛЮЧ" },
});
const data = await res.json();

Python

import requests

res = requests.get(
    "https://api.adresnitsa.ru/v1/details",
    params={"id": 26847188},
    headers={"Authorization": "Token ВАШ_КЛЮЧ"},
    timeout=5,
)
data = res.json()

PHP

<?php
$url = "https://api.adresnitsa.ru/v1/details?" . http_build_query([
    "id" => 26847188,
]);
$ctx = stream_context_create(["http" => [
    "header" => "Authorization: Token ВАШ_КЛЮЧ\r\n",
    "ignore_errors" => true,
]]);
$data = json_decode(file_get_contents($url, false, $ctx), true);

Ответ200 OKданные 2026.01.02 v.219

{
  "notFound": [],
  "results": [
    {
      "geo": {"lon": 37.6536694, "lat": 55.878344999999996, "qc": 0},
      "id": 26847188,
      "components": ["г Москва", "ул Сухонская", "д 11"],
      "postalCode": "127642",
      "oktmo": "45362000",
      "metro": [
        {
          "distance": 1.1,
          "colour": "#ffa500",
          "line": "Калужско-Рижская",
          "name": "Медведково"
        },
        {
          "distance": 1.2,
          "colour": "#ffa500",
          "line": "Калужско-Рижская",
          "name": "Бабушкинская"
        },
        {
          "distance": 2.6,
          "colour": "#ffa500",
          "line": "Калужско-Рижская",
          "name": "Свиблово"
        }
      ],
      "address": "г Москва, ул Сухонская, д 11",
      "multiApartment": true,
      "lastChangedBy": {
        "typeName": "Распоряжение",
        "kindName": "Технический документ",
        "organisation": "ДЕПАРТАМЕНТ ГОРОДСКОГО ИМУЩЕСТВА ГОРОДА МОСКВЫ",
        "number": "71183",
        "date": "2022-12-05",
        "name": "О размещении реквизитов объектов адресации в Адресном реестре объектов недвижимости города Москвы и государственном адресном реестре"
      },
      "federalDistrict": "Центральный",
      "level": 10,
      "kind": "Дом",
      "ifnsFl": "7715",
      "kladr": "77000000000283600",
      "regionCode": "77",
      "addressParts": {
        "city": "г Москва",
        "street": "ул Сухонская",
        "region": "г Москва",
        "byLevel": [
          {"level": 1, "text": "г Москва", "id": 1405113},
          {"level": 8, "text": "ул Сухонская", "id": 1404570},
          {
            "level": 10,
            "kind": "Дом",
            "text": "д 11",
            "id": 26847188,
            "self": true
          }
        ]
      },
      "postFileDate": "2026-10-05",
      "ifnsUl": "7715",
      "cadastral": "77:02:0004008:1017",
      "country": "Россия",
      "timeZone": "Europe/Moscow",
      "osmDate": "2026-10-10",
      "isoCode": "RU-MOW",
      "levelName": "Здание (строение), сооружение",
      "geonameId": 524901,
      "postOffice": {
        "type": "О",
        "date": "2002-04-04",
        "name": "МОСКВА 642"
      },
      "guidActual": true,
      "beltway": {"hit": "IN_MKAD"},
      "guid": "5ee84ac0-eb9a-4b42-b814-2f5f7c27c255",
      "utcOffset": "UTC+3",
      "assignedBy": {
        "typeName": "Распоряжение",
        "kindName": "Нормативный документ",
        "organisation": "",
        "number": "10732",
        "date": "2017-04-14",
        "name": "О присвоении адреса объекту адресации"
      },
      "okato": "45280583000"
    }
  ]
}

По GUID

Тот же дом по GUID. Ответ такой же, как по id.

curl

curl -G https://api.adresnitsa.ru/v1/details \
  -H "Authorization: Token ВАШ_КЛЮЧ" \
  -d guid=5ee84ac0-eb9a-4b42-b814-2f5f7c27c255

JavaScript

const url = new URL("https://api.adresnitsa.ru/v1/details");
url.search = new URLSearchParams({ guid: "5ee84ac0-eb9a-4b42-b814-2f5f7c27c255" });
const res = await fetch(url, {
  headers: { Authorization: "Token ВАШ_КЛЮЧ" },
});
const data = await res.json();

Python

import requests

res = requests.get(
    "https://api.adresnitsa.ru/v1/details",
    params={"guid": "5ee84ac0-eb9a-4b42-b814-2f5f7c27c255"},
    headers={"Authorization": "Token ВАШ_КЛЮЧ"},
    timeout=5,
)
data = res.json()

PHP

<?php
$url = "https://api.adresnitsa.ru/v1/details?" . http_build_query([
    "guid" => "5ee84ac0-eb9a-4b42-b814-2f5f7c27c255",
]);
$ctx = stream_context_create(["http" => [
    "header" => "Authorization: Token ВАШ_КЛЮЧ\r\n",
    "ignore_errors" => true,
]]);
$data = json_decode(file_get_contents($url, false, $ctx), true);

По коду КЛАДР

Код КЛАДР улицы Сухонской в Москве.

curl

curl -G https://api.adresnitsa.ru/v1/details \
  -H "Authorization: Token ВАШ_КЛЮЧ" \
  -d kladr=77000000000283600

JavaScript

const url = new URL("https://api.adresnitsa.ru/v1/details");
url.search = new URLSearchParams({ kladr: "77000000000283600" });
const res = await fetch(url, {
  headers: { Authorization: "Token ВАШ_КЛЮЧ" },
});
const data = await res.json();

Python

import requests

res = requests.get(
    "https://api.adresnitsa.ru/v1/details",
    params={"kladr": "77000000000283600"},
    headers={"Authorization": "Token ВАШ_КЛЮЧ"},
    timeout=5,
)
data = res.json()

PHP

<?php
$url = "https://api.adresnitsa.ru/v1/details?" . http_build_query([
    "kladr" => "77000000000283600",
]);
$ctx = stream_context_create(["http" => [
    "header" => "Authorization: Token ВАШ_КЛЮЧ\r\n",
    "ignore_errors" => true,
]]);
$data = json_decode(file_get_contents($url, false, $ctx), true);

Ответ200 OKданные 2026.01.02 v.219

{
  "notFound": [],
  "results": [
    {
      "geo": {"lon": 37.653023399999995, "lat": 55.875414, "qc": 2},
      "id": 1404570,
      "components": ["г Москва", "ул Сухонская"],
      "metro": [
        {
          "distance": 0.9,
          "colour": "#ffa500",
          "line": "Калужско-Рижская",
          "name": "Бабушкинская"
        },
        {
          "distance": 1.4,
          "colour": "#ffa500",
          "line": "Калужско-Рижская",
          "name": "Медведково"
        },
        {
          "distance": 2.2,
          "colour": "#ffa500",
          "line": "Калужско-Рижская",
          "name": "Свиблово"
        }
      ],
      "oktmo": "45364000",
      "address": "г Москва, ул Сухонская",
      "lastChangedBy": {
        "typeName": "Приказ",
        "kindName": "Технический документ",
        "organisation": "ФЕДЕРАЛЬНАЯ СЛУЖБА ГОСУДАРСТВЕННОЙ СТАТИСТИКИ ФЕДЕРАЛЬНОЕ АГЕНТСТВО ПО ТЕХНИЧЕСКОМУ РЕГУЛИРОВАНИЮ И МЕТРОЛОГИИ",
        "number": "159-ст",
        "date": "2013-06-14",
        "name": "ОК 033-2013. Общероссийский классификатор территорий муниципальных образований"
      },
      "federalDistrict": "Центральный",
      "level": 8,
      "ifnsFl": "7715",
      "kladr": "77000000000283600",
      "regionCode": "77",
      "addressParts": {
        "city": "г Москва",
        "street": "ул Сухонская",
        "region": "г Москва",
        "byLevel": [
          {"level": 1, "text": "г Москва", "id": 1405113},
          {"level": 8, "self": true, "text": "ул Сухонская", "id": 1404570}
        ]
      },
      "postFileDate": "2026-10-05",
      "ifnsUl": "7715",
      "country": "Россия",
      "timeZone": "Europe/Moscow",
      "osmDate": "2026-10-10",
      "geonameId": 524901,
      "levelName": "Элемент улично-дорожной сети",
      "isoCode": "RU-MOW",
      "guidActual": true,
      "beltway": {"hit": "IN_MKAD"},
      "guid": "95dbf7fb-0dd4-4a04-8100-4f6c847564b5",
      "utcOffset": "UTC+3",
      "okato": "45280583000"
    }
  ]
}

Несколько сразу

Три id: дом, Казань и код, которого нет. Найденные — в results, ненайденный — в notFound.

curl

curl https://api.adresnitsa.ru/v1/details \
  -H "Authorization: Token ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"ids": [26847188, 169398, 4294967295]}'

JavaScript

const res = await fetch("https://api.adresnitsa.ru/v1/details", {
  method: "POST",
  headers: {
    Authorization: "Token ВАШ_КЛЮЧ",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ ids: [26847188, 169398, 4294967295] }),
});
const data = await res.json();

Python

import requests

res = requests.post(
    "https://api.adresnitsa.ru/v1/details",
    json={"ids": [26847188, 169398, 4294967295]},
    headers={"Authorization": "Token ВАШ_КЛЮЧ"},
    timeout=5,
)
data = res.json()

PHP

<?php
$body = json_encode(["ids" => [26847188, 169398, 4294967295]], JSON_UNESCAPED_UNICODE);
$ctx = stream_context_create(["http" => [
    "method" => "POST",
    "header" => "Authorization: Token ВАШ_КЛЮЧ\r\n" .
        "Content-Type: application/json\r\n",
    "content" => $body,
    "ignore_errors" => true,
]]);
$data = json_decode(file_get_contents("https://api.adresnitsa.ru/v1/details", false, $ctx), true);

Ответ200 OKданные 2026.01.02 v.219

{
  "notFound": [4294967295],
  "results": [
    {
      "geo": {"lon": 37.6536694, "lat": 55.878344999999996, "qc": 0},
      "id": 26847188,
      "components": ["г Москва", "ул Сухонская", "д 11"],
      "postalCode": "127642",
      "oktmo": "45362000",
      "metro": [
        {
          "distance": 1.1,
          "colour": "#ffa500",
          "line": "Калужско-Рижская",
          "name": "Медведково"
        },
        {
          "distance": 1.2,
          "colour": "#ffa500",
          "line": "Калужско-Рижская",
          "name": "Бабушкинская"
        },
        {
          "distance": 2.6,
          "colour": "#ffa500",
          "line": "Калужско-Рижская",
          "name": "Свиблово"
        }
      ],
      "address": "г Москва, ул Сухонская, д 11",
      "multiApartment": true,
      "lastChangedBy": {
        "typeName": "Распоряжение",
        "kindName": "Технический документ",
        "organisation": "ДЕПАРТАМЕНТ ГОРОДСКОГО ИМУЩЕСТВА ГОРОДА МОСКВЫ",
        "number": "71183",
        "date": "2022-12-05",
        "name": "О размещении реквизитов объектов адресации в Адресном реестре объектов недвижимости города Москвы и государственном адресном реестре"
      },
      "federalDistrict": "Центральный",
      "level": 10,
      "kind": "Дом",
      "ifnsFl": "7715",
      "kladr": "77000000000283600",
      "regionCode": "77",
      "addressParts": {
        "city": "г Москва",
        "street": "ул Сухонская",
        "region": "г Москва",
        "byLevel": [
          {"level": 1, "text": "г Москва", "id": 1405113},
          {"level": 8, "text": "ул Сухонская", "id": 1404570},
          {
            "level": 10,
            "kind": "Дом",
            "text": "д 11",
            "id": 26847188,
            "self": true
          }
        ]
      },
      "postFileDate": "2026-10-05",
      "ifnsUl": "7715",
      "cadastral": "77:02:0004008:1017",
      "country": "Россия",
      "timeZone": "Europe/Moscow",
      "osmDate": "2026-10-10",
      "isoCode": "RU-MOW",
      "levelName": "Здание (строение), сооружение",
      "geonameId": 524901,
      "postOffice": {
        "type": "О",
        "date": "2002-04-04",
        "name": "МОСКВА 642"
      },
      "guidActual": true,
      "beltway": {"hit": "IN_MKAD"},
      "guid": "5ee84ac0-eb9a-4b42-b814-2f5f7c27c255",
      "utcOffset": "UTC+3",
      "assignedBy": {
        "typeName": "Распоряжение",
        "kindName": "Нормативный документ",
        "organisation": "",
        "number": "10732",
        "date": "2017-04-14",
        "name": "О присвоении адреса объекту адресации"
      },
      "okato": "45280583000"
    },
    {
      "geo": {"lon": 49.1115022, "lat": 55.7946485, "qc": 4},
      "id": 169398,
      "components": ["г Казань"],
      "oktmo": "92701000001",
      "address": "г Казань",
      "lastChangedBy": {
        "typeName": "Приказ",
        "kindName": "Технический документ",
        "organisation": "Федеральное агентство по техническому регулированию и метрологии",
        "number": "159-ст",
        "date": "2013-06-14",
        "name": "О принятии и введении в действие Общероссийского классификатора территорий муниципальных образований ОК 033-2013"
      },
      "adminCentreMunicipality": true,
      "federalDistrict": "Приволжский",
      "level": 5,
      "ifnsFl": "1600",
      "kladr": "1600000100000",
      "regionCode": "16",
      "addressParts": {
        "city": "г Казань",
        "region": "Татарстан Респ",
        "byLevel": [
          {"level": 1, "text": "Респ Татарстан", "id": 169363},
          {"level": 5, "self": true, "text": "г Казань", "id": 169398}
        ]
      },
      "postFileDate": "2026-10-05",
      "ifnsUl": "1600",
      "country": "Россия",
      "timeZone": "Europe/Moscow",
      "osmDate": "2026-10-10",
      "geonameId": 551487,
      "levelName": "Город",
      "isoCode": "RU-TA",
      "guidActual": true,
      "guid": "93b3df57-4c89-44df-ac42-96f05e9cd3b9",
      "adminCentreSubject": true,
      "utcOffset": "UTC+3",
      "okato": "92401000000"
    }
  ]
}

Ответ

results — найденные объекты со всеми полями (все поля).
notFound — коды из запроса, которых нет в ГАР.