Последнее обновление: 25.08.2025

Как это работает?

Данные по почтовым индексам доступны в формате JSON по адресам вида:

https://sanmai.github.io/pindx/json/AAA/AAABBB.json

Где AAA - первые три цифры индекса, BBB - последние три.

Например, посмотрите данные для индекса 199151.

На этом сайте разрешены AJAX-запросы со сторонних сайтов (стоит разрешающий заголовок Access-Control-Allow-Origin). Например, мы можете проверять корректность ввода индекса в форме адреса.

Источник данных: эталонный справочник почтовых индексов объектов почтовой связи от дирекции технологий и информатизации ФГУП «Почта России». Сверка с исходным справочником происходит один раз в день. Сейчас используется БД от 25.08.2025.

О проблемах сообщайте.

Описание полей данных

Поле	Описание
Index	Почтовый индекс объекта почтовой связи в соответствии с действующей системой индексации.
OPSName	Наименование объекта почтовой связи.
OPSType	Тип объекта почтовой связи.
OPSSubm	Индекс вышестоящего по иерархии подчиненности объекта почтовой связи.
Region	Наименование области, края, республики, в которой находится объект почтовой связи.
Autonom	Наименование автономной области, в которой находится объект почтовой связи.
Area	Наименование района, в котором находится объект почтовой связи.
City	Наименование населенного пункта, в котором находится объект почтовой связи.
City1	Наименование подчиненного населенного пункта, в котором находится объект почтовой связи.
ActDate	Дата актуализации информации об объекте почтовой связи.
IndexOld	Почтовый индекс объект почтовой связи до ввода действующей системы индексации.

Пример использования с fetch()

// Получаем данные для индекса 123456
const postalCode = "123456";
const prefix = postalCode.substring(0, 3); // получаем первые 3 цифры: "123"

fetch(`https://sanmai.github.io/pindx/json/${prefix}/${postalCode}.json`)
  .then(response => response.json())
  .then(data => {
    console.log('Индекс:', data.Index);
    console.log('Регион:', data.Region);
    console.log('Район:', data.Area);
    console.log('Город:', data.City);
  })
  .catch(error => console.error('Почтовый индекс не найден:', error));

Ещё один пример с async/await и проверкой ошибок.

async function getPostalOffice(postalCode) {
  const prefix = postalCode.substring(0, 3);
  const response = await fetch(`https://sanmai.github.io/pindx/json/${prefix}/${postalCode}.json`);

  if (response.status === 404) {
    return null; // Почтовый индекс не найден
  }

  if (!response.ok) {
    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
  }

  return await response.json();
}

(async () => {
  const validCode = "123456";
  const invalidCode = "000000";

  const office = await getPostalOffice(validCode);
  if (office) {
    console.log(`Найден: ${office.OPSName}, ${office.Region}`);
  }
  
  const notFound = await getPostalOffice(invalidCode);
  if (!notFound) {
    console.log('Индекс не найден');
  }
})();

PHP клиент для доступа к API

Установка делается как обычно. Требуется PHP 7.0 и выше.

composer require sanmai/pindx-client

Пример использования:

<?php
require 'vendor/autoload.php';

$postalCode = 130980;

$client = new \RussianPostIndex\Client();
if ($office = $client->getOffice($postalCode)) {
    var_dump($office->getIndex()); // int(130980)
    var_dump($office->getName()); // string(25) "Москва EMS ММПО"
    var_dump($office->getType()); // string(8) "ММПО"
    var_dump($office->getSuperior()); // int(104040)
    var_dump($office->getRegion()); // string(12) "Москва"
    var_dump($office->getAutonomousRegion()); // string(0) ""
    var_dump($office->getArea()); // string(0) ""
    var_dump($office->getCity()); // string(0) ""
    var_dump($office->getDistrict()); // string(0) ""
    var_dump($office->getDate()->format('Y-m-d')); // string(10) "2017-04-28"
}

Более подробно в документации к библиотеке.