> For the complete documentation index, see [llms.txt](https://api-portal.novapost.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-portal.novapost.com/changelog-1/documentation-1/slovnik-zaboronenikh-vipuskiv-dlya-vregulyuvannya.md).

# Словник заборонених випусків для врегулювання

**Загальна інформація**

<table data-header-hidden><thead><tr><th width="163.5999755859375"></th><th></th></tr></thead><tbody><tr><td><strong>Назва методу</strong></td><td>Словник заборонених випусків для врегулювання</td></tr><tr><td><strong>HTTP Метод</strong></td><td>Повертає маніфест із посиланнями на офлайн-файли, що містять населені пункти, куди заборонено доставляти вантаж в Україні.</td></tr><tr><td><strong>Роут</strong></td><td>GET <code>/api.novapost.pl/v.1.0/dictionary/settlements/prohibited-issuance</code></td></tr><tr><td><strong>Авторизація</strong></td><td><code>Authorization: Bearer jwt-token…</code></td></tr></tbody></table>

**Опис**

Цей API надає щоденно оновлюваний маніфест українських розрахунків, де заборонено доставку відправлень. Маніфест містить посилання на локалізовані, стиснені за допомогою gzip-файли JSON з детальною інформацією про розрахунки та прапорцями заборони. Файли доступні як українською, так і англійською мовами для підтримки локалізації.&#x20;

Файли оновлюються щодня о 5:00 UTC.

### Основні можливості <a href="#path-parameters" id="path-parameters"></a>

| **Назва**     | Тип    | Обов'язковість | **Опис**                                    |
| ------------- | ------ | -------------- | ------------------------------------------- |
| Authorization | string | Yes            | `Bearer <token>`. Auth token of the client. |

Схема:&#x20;

<table data-header-hidden><thead><tr><th></th><th></th><th></th><th width="187"></th></tr></thead><tbody><tr><td>Назва</td><td>Тип </td><td>Null-доступ</td><td>Опис</td></tr><tr><td>id</td><td>int</td><td>Yes</td><td>Унікальний ідентифікатор запису про розрахунки.</td></tr><tr><td>name</td><td>string</td><td>No</td><td>Локалізована назва населеного пункту. (наприклад, «місто Авдіївка»). Мінімум 2 символи</td></tr><tr><td>country</td><td>object</td><td>No</td><td>Країна, до якої належить поселення. Має бути Україна.</td></tr><tr><td>country.code</td><td>string</td><td>No</td><td>2-букви країни (<code>"UA"</code>).</td></tr><tr><td>country.name</td><td>string</td><td>No</td><td>Назва країни відповідно до локалізації(наприклад <code>Ukraine</code>).</td></tr><tr><td>region</td><td>object</td><td>Yes</td><td>Деталі адміністративного поділу регіону.</td></tr><tr><td>region.id</td><td>number</td><td>Yes</td><td>Ідентифікатор регіону.</td></tr><tr><td>region.name</td><td>string</td><td>Yes</td><td>Назва адміністративного регіону, якому підпорядковується населений пункт.</td></tr><tr><td>region.parent</td><td>object</td><td>Yes</td><td>Материнська адміністративна одиниця (область), до якої належить регіон.</td></tr><tr><td>region.parent.id</td><td>number</td><td>Yes</td><td>Ідентифікатор батьківського регіону.</td></tr><tr><td>region.parent.name</td><td>string</td><td>Yes</td><td>Назва батьківського регіону (наприклад <code>Donetska oblast</code>).</td></tr><tr><td>latitude</td><td>number</td><td>Yes</td><td>Географічна широта населеного пункту в десяткових градусах (мін. -90┃макс. 90)</td></tr><tr><td>longitude</td><td>number</td><td>Yes</td><td>Географічна довгота населеного пункту в десяткових градусах (мін. -180┃макс. 180)</td></tr><tr><td>postCode1</td><td>string</td><td>Yes</td><td>Нижня межа діапазону поштових індексів населеного пункту або єдиний поштовий індекс, якщо існує лише один.</td></tr><tr><td>postCode2</td><td>string</td><td>Yes</td><td>Верхня межа поштового індексу; дорівнює postCode1, якщо один індекс.</td></tr><tr><td>alternativeNames</td><td>array of string</td><td>Yes</td><td>Масив альтернативних назв (латиницею та кирилицею, з/без «село/село»). Може бути порожнім ([]).</td></tr><tr><td>externalId</td><td>string</td><td>No</td><td>Зовнішній ключ.</td></tr><tr><td>prohibitedIssuance</td><td>boolean</td><td>No</td><td>Поле prohibitedIssuance вказує, чи заборонено відправлення (доставку) відправлень до цього населеного пункту. Якщо prohibitedIssuance має значення true, доставка відправлень до цього населеного пункту заборонена.</td></tr></tbody></table>

Приклад відповіді:

<https://api.novapost.pl/v.1.0/dictionary/settlements/prohibited-issuance>

```
{
    "unix_time": 1766120417,
    "urls": [
        "https://api-cdn.novapost.com/dictionary/settlements/prohibited-issuance/en/settlements.json.gz",
        "https://api-cdn.novapost.com/dictionary/settlements/prohibited-issuance/uk/settlements.json.gz"
    ]
}
```

Використовуйте URL-адреси, надані в маніфесті, щоб завантажити найновіші списки поселень для кожної підтримуваної локалізації.

Приклад структури pfgbne JSON '

```
[
  {
    "id": 108335,
    "name": "urban villagе Abrykosivka",
    "country": {
      "code": "UA",
      "name": "Ukraine"
    },
    "region": {
      "id": 964,
      "name": "Oleshkivskyi raion",
      "parent": {
        "id": 417,
        "name": "Khersonska oblast"
      }
    },
    "latitude": 46.488153,
    "longitude": 33.071226,
    "postCode1": "75134",
    "postCode2": "75134",
    "alternativeNames": [
      "abrykosivka",
      "селище абрикосівка",
      "selishche abrikosivka",
      "поселок абрикосовка",
      "poselok abrikosovka",
      "urban villagе abrykosivka",
      "urban village abrykosivka"
    ],
    "externalId": "0ddee0f8-4b3a-11e4-ab6d-005056801329",
    "prohibitedSending": false,
    "prohibitedIssuance": true
  }
  ]
```

| **HTTP-code** | **Status** | **Description**                                         |
| ------------- | ---------- | ------------------------------------------------------- |
| 200           | OK         | Запит успішно виконано. Сервер відповів належним чином. |
| 400           | Not Found  | Повідомлення про помилку: "Дія\_не\_доступна"           |

&#x20;cURL

```
curl --location 'https://api-stage.novapost.pl/v.1.0/dictionary/settlements/prohibited-issuance' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6InByaXZhdGU6MmU1OWI1ZjEtYzIwYS00MWFlLTk3N2ItYzU5MWJiZmY2ODA5IiwidHlwIjoiSldUIn0.eyJhdF9oYXNoIjoiRG9SNVU5MmNaakRQT0dUbDJuWU94QSIsImF1ZCI6WyJmZWU5dVlpYUFoVzBvcG9vLmF1dGguYXBwcy5ub3ZhcG9zdC5jb20iXSwiYXV0aF90aW1lIjoxNzY2NDkxMTg3LCJjb3VudHJ5X2NvZGUiOiJVQSIsImVtYWlsIjoiIiwiZXhwIjoxNzY3MDk2MDI5LCJpYXQiOjE3NjY0OTEyMjksImlzcyI6Imh0dHBzOi8vYXV0aC1zdGFnZS5ub3ZhcG9zdC5jb20vIiwianRpIjoiZDVkOWZiNmItYmNlNy00YWYyLTgyMGYtYWQ5MGMxODQwMTI3IiwibmFtZSI6ItCQ0LzQsdGA0L7RgSDQnNCw0YDRltCw0L3QvdCwINCS0ZbQtNGB0YPRgtC90ZQiLCJwYXJ0bmVySW5mbyI6eyJjb3VudHJ5Q29kZSI6IiIsImRpdmlzaW9uSWQiOjAsInJvbGVzIjpudWxsfSwicGhvbmUiOiIzODA5MzkxNTM3OTkiLCJyYXQiOjE3NjY0OTExNjQsInJlZ2lvbl9jb2RlIjoiVUEiLCJzaWQiOiIxNGRjN2JmOC01YTUwLTRhM2MtYWE3My03ZjhkYjdkNjAwOTgiLCJzdWIiOiJlZjA0ZDZlZS0xNjE0LTQ5YzAtYmFiYS01NmY1NzQ2OThjNWEifQ.H5DNONyaiiA4kM7mkLK_AEFCCptJmjUg-8VcSm-eEsQ-ijt-PC3UXljlcyKpc1RF12ZtJhBPls1qiwh26PnFC8_cabE1N-XR-U6NpAlxC20hc0Ik5EFI9YMmfuJTQhVH1TwlFTo4TFmDO6Bf-UG5hrfwiw3dDRs-rs-Ql8SXKGvLx6_h8421rCaNKUoX--D4drMJjHljR82FyKnrSfdeu8E9MFHp5KeIEm6cwYasTPNEaHTK_njorlqvPFjvdIGHc9XpQv8naHQtDJJdb08LM2jbFApm86ceHRlmOUvEe2vZuWQgbcdhDUQYtLUlxboltlq6WGxq7IaooEXprt_ihRMkwHMvNyoqo4Wv7ZTUv2vi0zT7rtqlGHRsjPTMTtvH1lVMJEIsMy1nQL1aAr8gfKzU2Bt_B4zyBahu58TLtWhs1y27dZCmuXye8tdwnjAA5kwTxgNYXryZSwxepGyyH4m-mP_gUdY5rxgSbFQwIUyOsK9lr0avqob17860LqTHnUtLNykH6S9-95h1HWzJ8L4HE1ml_a2OtwGPo_dkkq4kt1AfSZF_sCCovHNoS4BlVVHuVK6WWD-SVc01WauNG4dwm5L3jxIyb79QuI52G93zqEy_h4LBBVf22jnTVjRzOCywcWAKVO0zDPkkK-KuNinqVvlVkWiffBNtDnK-fwY'
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api-portal.novapost.com/changelog-1/documentation-1/slovnik-zaboronenikh-vipuskiv-dlya-vregulyuvannya.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.