# API сервісу Тендер

# Перелік методів API сервісу Тендер

<p class="callout info">Всі запити нижче перерахованих API методів платформи EDIN 2.0 направляються на адресу: [https://edo-v2.edin.ua](https://edo-v2.edin.ua/)</p>

<p class="callout warning">Для роботи з цими методами користувач повинен бути [авторизованим](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi).</p>

##### **Робота зі ставками**

<table border="1" id="bkmrk-%D0%A1%D1%82%D0%B2%D0%BE%D1%80%D0%B8%D1%82%D0%B8-%D1%81%D0%B5%D1%80%D1%82%D0%B8%D1%84%D1%96%D0%BA%D0%B0%D1%82-" style="width: 99.881%;"><tbody><tr style="background-color: rgb(236, 240, 241);"><td style="width: 57.2764%;">Зробити ставку по лоту (Учасник)

</td><td style="width: 42.6998%;">[POST /api/v1/tender/lot/bets](https://wiki-v2.edin.ua/books/robota-z-api/page/zrobiti-stavku-po-lotu-ucasnik-post-apiv1tenderlotbets)</td></tr><tr><td style="width: 57.2764%;">Видалити ставку по лоту тендера (Організатор)

</td><td style="width: 42.6998%;">[DELETE /api/v1/tender/lot/bets](https://wiki-v2.edin.ua/books/robota-z-api/page/vidaliti-stavku-po-lotu-tendera-organizator-delete-apiv1tenderlotbets)</td></tr></tbody></table>

##### **Робота з тендерами**

<table border="1" id="bkmrk-%D0%A1%D1%82%D0%B2%D0%BE%D1%80%D0%B8%D1%82%D0%B8-%D0%BD%D0%BE%D0%B2%D0%B8%D0%B9-%D1%82%D0%B5%D0%BD%D0%B4%D0%B5" style="width: 99.881%; height: 592.8px;"><tbody><tr style="background-color: rgb(236, 240, 241); height: 35.2px;"><td style="width: 57.1471%; height: 35.2px;">Створити новий тендер (чернетку)

</td><td style="width: 42.8291%; height: 35.2px;">[POST /api/v1/tender/auctions](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-novii-tender-cernetku-post-apiv1tenderauctions)</td></tr><tr style="height: 35.2px;"><td style="width: 57.1471%; height: 35.2px;">Опублікувати тендер

</td><td style="width: 42.8291%; height: 35.2px;">[PATCH /api/v1/tender/auctions/publish](https://wiki-v2.edin.ua/books/robota-z-api/page/opublikuvati-tender-patch-apiv1tenderauctionspublish)</td></tr><tr style="background-color: rgb(236, 240, 241); height: 35.2px;"><td style="width: 57.1471%; height: 35.2px;">Отримати дані тендера (за id)

</td><td style="width: 42.8291%; height: 35.2px;">[GET /api/v1/tender/auction](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-dani-tendera-za-id-get-apiv1tenderauction)</td></tr><tr style="height: 35.2px;"><td style="width: 57.1471%; height: 35.2px;">Отримати список тендерів з "Чернеток"

</td><td style="width: 42.8291%; height: 35.2px;">[GET /api/v1/tender/auctions/drafts](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-spisok-tenderiv-z-cernetok-get-apiv1tenderauctionsdrafts)</td></tr><tr style="background-color: rgb(236, 240, 241); height: 35.2px;"><td style="width: 57.1471%; height: 35.2px;">Отримати список тендерів з "Мої тендери"

</td><td style="width: 42.8291%; height: 35.2px;">[GET /api/v1/tender/auctions/my](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-spisok-tenderiv-z-moyi-tenderi-get-apiv1tenderauctionsmy)</td></tr><tr style="height: 35.2px;"><td style="width: 57.1471%; height: 35.2px;">Отримати список з "Усі тендери"

</td><td style="width: 42.8291%; height: 35.2px;">[GET /api/v1/tender/auctions/all](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-spisok-z-usi-tenderi-get-apiv1tenderauctionsall)</td></tr><tr style="background-color: rgb(236, 240, 241); height: 35.2px;"><td style="width: 57.1471%; height: 35.2px;">Отримати дані про перегляди тендера (за id)

</td><td style="width: 42.8291%; height: 35.2px;">[GET /api/v1/tender/auction/views](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-dani-pro-peregliadi-tendera-za-id-get-apiv1tenderauctionviews)</td></tr><tr style="height: 35.2px;"><td style="width: 57.1471%; height: 35.2px;">Отримання списку тендерів для неавторизованого користувача

</td><td style="width: 42.8291%; height: 35.2px;">[GET /api/v1/tender/guest/auctions/all](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-spisok-tenderiv-dlia-neavtorizovanogo-koristuvaca-get-apiv1tenderguestauctionsall)</td></tr><tr style="background-color: rgb(236, 240, 241); height: 35.2px;"><td style="width: 57.1471%; height: 35.2px;">Завершити тендер (Організатор)

</td><td style="width: 42.8291%; height: 35.2px;">[PATCH /api/v1/tender/auctions/close](https://wiki-v2.edin.ua/books/robota-z-api/page/zaversiti-tender-organizator-patch-apiv1tenderauctionsclose)</td></tr><tr style="height: 35.2px;"><td style="width: 57.1471%; height: 35.2px;">Запросити компанії взяти участь в тендері (Організатор)

</td><td style="width: 42.8291%; height: 35.2px;">[POST /api/v1/tender/auction/access/invite](https://wiki-v2.edin.ua/books/robota-z-api/page/zaprositi-kompaniyi-vziati-ucast-v-tenderi-organizator-post-apiv1tenderauctionaccessinvite)</td></tr><tr style="background-color: rgb(236, 240, 241); height: 35.2px;"><td style="width: 57.1471%; height: 35.2px;">Подати заявку на участь в закритому аукціоні (Учасник)

</td><td style="width: 42.8291%; height: 35.2px;">[POST /api/v1/tender/auction/access/request](https://wiki-v2.edin.ua/books/robota-z-api/page/podati-zaiavku-na-ucast-v-zakritomu-aukcioni-ucasnik-post-apiv1tenderauctionaccessrequest)</td></tr><tr style="height: 35.2px;"><td style="width: 57.1471%; height: 35.2px;">Отримати дані по заявкам на участь в закритих аукціонах (Учасник)

</td><td style="width: 42.8291%; height: 35.2px;">[GET /api/v1/tender/auction/access/company/outgoing](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-dani-po-zaiavkam-na-ucast-v-zakritix-aukcionax-ucasnik-get-apiv1tenderauctionaccesscompanyoutgoing)</td></tr><tr style="background-color: rgb(236, 240, 241); height: 35.2px;"><td style="width: 57.1471%; height: 35.2px;">Схвалити заявку на участь в закритому аукціоні (Організатор)

</td><td style="width: 42.8291%; height: 35.2px;">[PATCH /api/v1/tender/auction/access/confirm](https://wiki-v2.edin.ua/books/robota-z-api/page/sxvaliti-zapit-na-ucast-v-zakritomu-aukcioni-organizator-patch-apiv1tenderauctionaccessconfirm)</td></tr><tr style="height: 35.2px;"><td style="width: 57.1471%; height: 35.2px;">Відхилити заявку на участь в закритому аукціоні (Організатор)

</td><td style="width: 42.8291%; height: 35.2px;">[PATCH /api/v1/tender/auction/access/reject](https://wiki-v2.edin.ua/books/robota-z-api/page/vidxiliti-zaiavku-na-ucast-v-zakritomu-aukcioni-organizator-patch-apiv1tenderauctionaccessreject)</td></tr><tr style="height: 35.2px;"><td style="width: 57.1471%; background-color: rgb(236, 240, 241); height: 35.2px;">Вибір доступних користувачів для компанії

</td><td style="width: 42.8291%; background-color: rgb(236, 240, 241); height: 35.2px;">[GET /api/v1/tender/users](https://wiki-v2.edin.ua/books/robota-z-api/page/vibir-dostupnix-koristuvaciv-po-kompaniyi-get-apiv1tenderusers)</td></tr><tr style="height: 35.2px;"><td style="width: 57.1471%; height: 35.2px;">Надати доступ до вже опублікованого тендера

</td><td style="width: 42.8291%; height: 35.2px;">[POST /api/v1/tender/auction/users](https://wiki-v2.edin.ua/books/robota-z-api/page/nadati-dostup-koristuvacam-do-vze-opublikovanogo-tendera-post-apiv1tenderauctionusers)</td></tr><tr style="height: 29.6px;"><td style="width: 57.1471%; background-color: rgb(236, 240, 241); height: 29.6px;">Закрити доступ до вже опублікованого тендера

</td><td style="width: 42.8291%; background-color: rgb(236, 240, 241); height: 29.6px;">[DELETE /api/v1/tender/auction/users](https://wiki-v2.edin.ua/books/robota-z-api/page/nadati-dostup-koristuvacam-do-vze-opublikovanogo-tendera-post-apiv1tenderauctionusers)</td></tr></tbody></table>

##### **Вкладення**

<table border="1" id="bkmrk-%D0%94%D0%BE%D0%B4%D0%B0%D1%82%D0%B8-%D0%B2%D0%BA%D0%BB%D0%B0%D0%B4%D0%B5%D0%BD%D0%BD%D1%8F-%D0%B4%D0%BE-" style="width: 99.881%;"><tbody><tr style="background-color: rgb(236, 240, 241);"><td style="width: 57.1471%;">Додати вкладення до тендера, лота (Організатор) / Додати вкладення до ставки (Учасник)

</td><td style="width: 42.8291%;">[POST /api/v1/tender/attachments](https://wiki-v2.edin.ua/books/robota-z-api/page/dodati-vkladennia-do-tendera-lota-organizator-dodati-vkladennia-do-stavki-ucasnik-post-apiv1tenderattachments)</td></tr><tr><td style="width: 57.1471%;">Отримати список вкладень до тендера/лота/ставки

</td><td style="width: 42.8291%;">[GET /api/v1/tender/attachments](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-spisok-vkladen-do-tenderalotastavki-get-apiv1tenderattachments)</td></tr><tr style="background-color: rgb(236, 240, 241);"><td style="width: 57.1471%;">Отримати файл-вкладення до тендера/лота/ставки

</td><td style="width: 42.8291%;">[GET /api/v1/tender/attachment](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-fail-vkladennia-do-tenderalotastavki)</td></tr><tr><td style="width: 57.1471%;">Видалити вкладення до тендера / лота (Організатор)

</td><td style="width: 42.8291%;">[DELETE /api/v1/tender/attachment](https://wiki-v2.edin.ua/books/robota-z-api/page/vidaliti-vkladennia-do-tendera-lota-organizator-delete-apiv1tenderattachment)</td></tr></tbody></table>

##### **Робота з підписками**

<table border="1" id="bkmrk-%D0%9E%D1%82%D1%80%D0%B8%D0%BC%D0%B0%D1%82%D0%B8-%D1%81%D0%BF%D0%B8%D1%81%D0%BE%D0%BA-%D0%BA%D0%BE%D1%80%D0%B8" style="width: 99.881%;"><tbody><tr style="background-color: rgb(236, 240, 241);"><td style="width: 57.1471%;">Отримати список користувачів, на яких підписаний поточний Адміністратор акаунта

</td><td style="width: 42.8291%;">[GET /api/v1/tender/user/subscribes](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-spisok-koristuvaciv-na-iakix-pidpisanii-potocnii-administrator-akaunta-get-apiv1tenderusersubscribes)</td></tr><tr><td style="width: 57.1471%;">Додати підписку на користувача (Адміністратор акаунта)

</td><td style="width: 42.8291%;">[POST /api/v1/tender/user/subscribes](https://wiki-v2.edin.ua/books/robota-z-api/page/dodati-pidpisku-na-koristuvaca-administrator-akaunta-post-apiv1tenderusersubscribes)</td></tr><tr style="background-color: rgb(236, 240, 241);"><td style="width: 57.1471%;">Видалити підписку на користувача (Адміністратор акаунта)

</td><td style="width: 42.8291%;">[DELETE /api/v1/tender/user/subscribes](https://wiki-v2.edin.ua/books/robota-z-api/page/vidaliti-pidpisku-na-koristuvaca-administrator-akaunta-delete-apiv1tenderusersubscribes)</td></tr></tbody></table>

##### **Довідники**

<table border="1" id="bkmrk-%D0%9E%D1%82%D1%80%D0%B8%D0%BC%D0%B0%D1%82%D0%B8-%D0%B4%D0%BE%D0%B2%D1%96%D0%B4%D0%BD%D0%B8%D0%BA-%D0%BA%D0%B0" style="width: 99.881%;"><tbody><tr style="background-color: rgb(236, 240, 241);"><td style="width: 57.1471%;">Отримати довідник категорій

</td><td style="width: 42.8291%;">[GET /api/v1/tender/categories](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-dovidnik-kategorii-get-apiv1tendercategories)</td></tr><tr><td style="width: 57.1471%;">Отримати довідник валют

</td><td style="width: 42.8291%;">[GET /api/v1/tender/currency](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-dovidnik-valiut-get-apiv1tendercurrency)</td></tr><tr style="background-color: rgb(236, 240, 241);"><td style="width: 57.1471%;">Отримати довідник регіонів

</td><td style="width: 42.8291%;">[GET /api/v1/tender/regions](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-dovidnik-regioniv-get-apiv1tenderregions)</td></tr><tr><td style="width: 57.1471%;">Отримати довідник одиниць виміру

</td><td style="width: 42.8291%;">[GET /api/v1/tender/units](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-dovidnik-odinic-vimiru-get-apiv1tenderunits)</td></tr></tbody></table>

##### **Довідник учасників**

<table border="1" id="bkmrk-%D0%9E%D1%82%D1%80%D0%B8%D0%BC%D0%B0%D1%82%D0%B8-%D1%81%D0%BF%D0%B8%D1%81%D0%BE%D0%BA-%D0%B2%D1%81%D1%96%D1%85" style="width: 99.881%;"><tbody><tr style="background-color: rgb(236, 240, 241);"><td style="width: 57.1463%;">Отримати список всіх наявних груп учасників

</td><td style="width: 42.8299%;">[GET /api/v1/tender/participant\_group/list](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-spisok-vsix-naiavnix-grup-ucasnikiv-get-apiv1tenderparticipant-grouplist)</td></tr><tr><td style="width: 57.1463%;">Отримати дані групи учасників

</td><td style="width: 42.8299%;">[GET /api/v1/tender/participant\_group](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-dani-grupi-ucasnikiv-get-apiv1tenderparticipant-group)</td></tr><tr style="background-color: rgb(236, 240, 241);"><td style="width: 57.1463%;">Створити/Редагувати групу учасників

</td><td style="width: 42.8299%;">[POST /api/v1/tender/participant\_group](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoritiredaguvati-grupu-ucasnikiv-post-apiv1tenderparticipant-group)</td></tr><tr><td style="width: 57.1463%;">Видалити групу учасників

</td><td style="width: 42.8299%;">[DELETE /api/v1/tender/participant\_group](https://wiki-v2.edin.ua/books/robota-z-api/page/vidaliti-grupu-ucasnikiv-delete-apiv1tenderparticipant-group)</td></tr></tbody></table>

# Помилки при роботі з API

Загальні помилки при роботі з API (для всіх сервісів EDIN) можна подивитись за [посиланням](https://wiki-v2.edin.ua/books/robota-z-api/page/zagalni-pomilki-pri-roboti-z-api-vsi-servisi-edin-SLH).

# Видалити групу учасників DELETE /api/v1/tender/participant_group

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-d"><table class="colwidths-given docutils align-default" style="width: 78.8095%;"><colgroup><col style="width: 22.4084%;"></col><col style="width: 77.5526%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>DELETE

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/participant\_group**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**group\_id** (обов’язково) var - ідентифікатор групи учасників

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

</div>**RESPONSE**

Код сервера 200 (ok).

# Створити/Редагувати групу учасників POST /api/v1/tender/participant_group

<p class="callout info">Вибір дії (створення або редагування): якщо в body запиту присутній ідентифікатор групи учасників (параметр **groupId**), то група із зазначеним **Id** підлягає редагуванню. Відсутність в запиті параметра **groupId** веде до створення нової групи учасників.</p>

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.4839%;"></col><col style="width: 84.4923%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/participant\_group**

</td></tr><tr class="row-even"><td>**Headers**

</td><td> </td></tr><tr class="row-odd"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-even"><td>Content-Type

</td><td>application/json

</td></tr><tr class="row-odd"><td>**REQUEST**

</td><td> </td></tr><tr class="row-even"><td>JSON Body

</td><td>В тілі запиту передається об’єкт з [даними групи учасників](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-participantgroup). При редагуванні групи важливо передавати всі необхідні ідентифікатори груп та учасників (**id**), наприклад «нові та попередні», оскільки запит перезаписує всі значення.

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** передається передається об’єкт з [даними групи учасників](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-participantgroup) (об'єкт PatrticipantGroup).

# Отримати дані групи учасників GET /api/v1/tender/participant_group

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 78.8095%;"><colgroup><col style="width: 22.4084%;"></col><col style="width: 77.5526%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/participant\_group**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**group\_id** (обов’язково) var - ідентифікатор групи учасників

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** передається об’єкт з [даними групи учасників](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-participantgroup) (об'єкт ParticipantGroup).

# Отримати список всіх наявних груп учасників GET /api/v1/tender/participant_group/list

**REQUEST**

<div class="document" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g" itemscope="itemscope" itemtype="http://schema.org/Article" role="main"><div itemprop="articleBody"><div class="section"><div class="wy-table-responsive"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 14.6552%;"></col><col style="width: 85.3209%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/participant\_group/list**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**limit** (опціонально) int - ліміт вибірки (за замовчуванням=20);

**offset** (опціонально) int - зміщення відносно верхньої межі вибірки (за замовчуванням=0);

**count** (опціонально) boolean - при значенні true у відповідь пердається лише число - загальна кількість груп учасників.

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

</div></div></div></div>**RESPONSE**

В тілі **відповіді** передається передаються [дані груп учасників](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-participantgroup) у вигляді масиву об’єктів.

<div class="document" id="bkmrk-" itemscope="itemscope" itemtype="http://schema.org/Article" role="main"><div itemprop="articleBody"><div class="section" id="bkmrk--1"></div></div></div>

# Отримати довідник одиниць виміру GET /api/v1/tender/units

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 65.2381%;"><colgroup><col style="width: 25.2228%;"></col><col style="width: 74.7407%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/units**

</td></tr><tr class="row-even"><td>**Headers**

</td><td> </td></tr><tr class="row-odd"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-even"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** передається [довідник одиниць виміру](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-unit) (масив об’єктів **Unit**).

# Отримати довідник регіонів GET /api/v1/tender/regions

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 65.5952%;"><colgroup><col style="width: 23.6336%;"></col><col style="width: 76.3301%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/regions**

</td></tr><tr class="row-even"><td>**Headers**

</td><td> </td></tr><tr class="row-odd"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-even"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** передається [довідник регіонів](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-region) (масив об’єктів **Region**).

# Отримати довідник валют GET /api/v1/tender/currency

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 65.5952%;"><colgroup><col style="width: 24.541%;"></col><col style="width: 75.4226%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/currency**

</td></tr><tr class="row-even"><td>**Headers**

</td><td> </td></tr><tr class="row-odd"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-even"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** передається [довідник валют](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-currency) (масив об’єктів **Currency**).

# Отримати довідник категорій GET /api/v1/tender/categories

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 97.619%;"><colgroup><col style="width: 15.5363%;"></col><col style="width: 84.4366%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/categories**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**ref\_id** (опціонально) String - ідентифікатор материнської категорії;

**query** (опціонально) String - текст пошуку (пошук здійснюється за назвою чи кодом категорії);

**limit** (опціонально) int - ліміт вибірки;

**offset** (опціонально) int - зміщення відносно верхньої межі вибірки (за замовчуванням=0)

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** передається [довідник категорій](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-category) (масив об’єктів **Category**).

# Видалити підписку на користувача (Адміністратор акаунта) DELETE /api/v1/tender/user/subscribes

<p class="callout info">Даний метод може бути виконаний лише від імені Адміністратора акаунта.</p>

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-d"><table class="colwidths-given docutils align-default" style="width: 78.8095%;"><colgroup><col style="width: 23.5559%;"></col><col style="width: 76.4031%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>DELETE

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/user/subscribes**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**user\_id** (обов’язково) long - ідентифікатор користувача

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** передається масив кориcтувачів, на яких оформлена підписка (масив об’єктів [User](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-user-dlia-servisu-tender) ).

# Додати підписку на користувача (Адміністратор акаунта) POST /api/v1/tender/user/subscribes

<p class="callout info">Даний метод може бути виконаний лише від імені Адміністратора акаунта.</p>

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 79.881%;"><colgroup><col style="width: 19.2565%;"></col><col style="width: 80.71%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/user/subscribes**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**user\_id** (обов’язково) long - ідентифікатор користувача

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** передається масив користувачів, на яких оформлена підписка (масив об’єктів [User](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-user-dlia-servisu-tender) ).

# Отримати список користувачів, на яких підписаний поточний Адміністратор акаунта GET /api/v1/tender/user/subscribes

<p class="callout info">Даний метод може бути виконаний лише від імені Адміністратора акаунта.</p>

**REQUEST**

<div class="document" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g" itemscope="itemscope" itemtype="http://schema.org/Article" role="main"><div itemprop="articleBody"><div class="section"><div class="wy-table-responsive"><table class="colwidths-given docutils align-default" style="width: 79.2857%;"><colgroup><col style="width: 27.5716%;"></col><col style="width: 72.3754%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/user/subscribes**

</td></tr><tr class="row-even"><td>**Headers**

</td><td> </td></tr><tr class="row-odd"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-even"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

</div></div></div></div>**RESPONSE**

В тілі **відповіді** передається масив користувачів, на яких оформлена підписка (масив об’єктів [User](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-user-dlia-servisu-tender) ).

<div class="document" id="bkmrk-" itemscope="itemscope" itemtype="http://schema.org/Article" role="main"><div itemprop="articleBody"><div class="section" id="bkmrk--1"></div></div></div>

# Видалити вкладення до тендера / лота (Організатор) DELETE /api/v1/tender/attachment

<p class="callout info">Видалити вкладення до тендера / лота може лише Організатор тендера чи [Супер адміністратор](https://wiki.edin.ua/uk/latest/Personal_Cabinet/PCInstruction.html#user-roles) акаунта організації!</p>

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-d"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 14.7733%;"></col><col style="width: 85.2029%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>DELETE

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/attachment**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**auction\_id** (обов’язково) long - ідентифікатор тендера;

**attach\_id** (обов’язково) long - ідентифікатор вкладення (значення **id** параметра з [Отримання списку вкладень до тендера/лота/ставки](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-spisok-vkladen-do-tenderalotastavki-get-apiv1tenderattachments))

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

</div>**RESPONSE**

Код сервера 200 (ok).

# Отримати файл-вкладення до тендера/лота/ставки

**REQUEST**

<div class="document" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g" itemscope="itemscope" itemtype="http://schema.org/Article" role="main"><div itemprop="articleBody"><div class="section"><div class="wy-table-responsive"><table class="colwidths-given docutils align-default" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 15.1304%;">**URL**

</td><td style="width: 84.8458%;"> </td></tr><tr class="row-even"><td style="width: 15.1304%;">Метод запиту

</td><td style="width: 84.8458%;">GET

</td></tr><tr class="row-odd"><td style="width: 15.1304%;">URL запиту

</td><td style="width: 84.8458%;">**/api/v1/tender/attachment**

</td></tr><tr class="row-even"><td style="width: 15.1304%;">URL параметри

</td><td style="width: 84.8458%;">**attach\_id** (обов’язково) long - ідентифікатор вкладення (значення **id** параметра з [Отримання списку вкладень до тендера/лота/ставки](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-spisok-vkladen-do-tenderalotastavki-get-apiv1tenderattachments))

</td></tr><tr class="row-odd"><td style="width: 15.1304%;">**Headers**

</td><td style="width: 84.8458%;"> </td></tr><tr class="row-even"><td style="width: 15.1304%;">Authorization

</td><td style="width: 84.8458%;">**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 15.1304%;">Content-Type

</td><td style="width: 84.8458%;">[MIME типізація](https://uk.wikipedia.org/wiki/MIME_%D1%82%D0%B8%D0%BF) згідно типу файлу-вкла дення

</td></tr></tbody></table>

</div></div></div></div>**RESPONSE**

В тілі **відповіді** передається файл-вкладення.

<div class="document" id="bkmrk-" itemscope="itemscope" itemtype="http://schema.org/Article" role="main"><div itemprop="articleBody"><div class="section" id="bkmrk--1"></div></div></div>

# Отримати список вкладень до тендера/лота/ставки GET /api/v1/tender/attachments

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 97.2619%;"><colgroup><col style="width: 16.4202%;"></col><col style="width: 83.6778%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/attachments**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**auction\_id** (обов’язково) long - ідентифікатор тендера;

**file\_name** (обов’язково) String - назва файлу разом з його розширенням;

**lot\_id** (опціонально) long - ідентифікатор лоту тендера;

**bet\_id** (опціонально) long - ідентифікатор ставки

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** передаються [дані всіх наявних вкладень](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-attachment-dlia-servisu-tender) (масив об’єктів Attachment).

# Додати вкладення до тендера, лота (Організатор) / Додати вкладення до ставки (Учасник) POST /api/v1/tender/attachments

<p class="callout warning">Додати вкладення до тендера та лота Організатор може лише **до початку тендера**! Вкладення зі сторони Учасника додається до вже зробленої ним ставки! До кожного тендера / лота / ставки можливо додати до 5 файлів!</p>

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 97.9762%;"><colgroup><col style="width: 16.908%;"></col><col style="width: 83.0677%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/attachments**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**auction\_id** (обов’язково) long - ідентифікатор тендера;

**file\_name** (обов’язково) String - назва файлу разом з його розширенням;

**lot\_id** (опціонально) long - ідентифікатор лоту тендера;

**bet\_id** (опціонально) long - ідентифікатор ставки

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** передаються [дані доданого вкладення](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-attachment-dlia-servisu-tender) (об’єкт Attachment).

# Відхилити заявку на участь в закритому аукціоні (Організатор) PATCH /api/v1/tender/auction/access/reject

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 14.4186%;"></col><col style="width: 85.5576%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>PATCH

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/auction/access/reject**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**auction\_id** (обов’язково) long - ідентифікатор аукціона (тендера)

**request\_id** (обов’язково) long - ідентифікатор запиту

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr><tr class="row-even"><td>**REQUEST**

</td><td> </td></tr><tr class="row-odd"><td>JSON Body

</td><td>В тілі запиту в текстовому вигляді опціонально може передаватись коментар до заявки на участь (для Учасника)

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** (json) передаються дані заявки на участь в закритому аукціоні (об’єкт [Access](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-access-dani-zapitu-na-ucast-v-zakritomu-aukcioni)).

# Схвалити запит на участь в закритому аукціоні (Організатор) PATCH /api/v1/tender/auction/access/confirm

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default"><colgroup><col></col><col></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>PATCH

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/auction/access/confirm**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**auction\_id** (обов’язково) long - ідентифікатор аукціона (тендера)

**request\_id** (обов’язково) long - ідентифікатор запиту

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr><tr class="row-even"><td>**REQUEST**

</td><td> </td></tr><tr class="row-odd"><td>JSON Body

</td><td>В тілі запиту в текстовому вигляді опціонально може передаватись коментар до запиту на участь (для Учасника)

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** (json) передаються дані заявки на участь в закритому аукціоні (об’єкт [Access](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-access-dani-zapitu-na-ucast-v-zakritomu-aukcioni)).

# Отримати дані по заявкам на участь в закритих аукціонах (Учасник) GET /api/v1/tender/auction/access/company/outgoing

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default"><colgroup><col></col><col></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/auction/access/company/outgoing**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**auction\_id** (опціонально) long - ідентифікатор аукціона (тендера)

**company\_id** (обов’язково) long - ідентифікатор компанії, від якої здійснюється запит

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** (json) передаються дані заявкок на участь в закритих аукціонах (масив об’єктів [Access](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-access-dani-zapitu-na-ucast-v-zakritomu-aukcioni)).

# Подати заявку на участь в закритому аукціоні (Учасник) POST /api/v1/tender/auction/access/request

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default"><colgroup><col></col><col></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/auction/access/request**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**auction\_uuid** (обов’язково) long - унікальний ідентифікатор аукціона (тендера)

**company\_id** (обов’язково) long - ідентифікатор компанії, від якої здійснюється запит

**contact\_name** (опціонально) String (250) - контактна особа (ПІБ)

**contact\_phone** (опціонально) String (50) - контактний телефон

**contact\_email** (опціонально) String (250) - контактний email

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr><tr class="row-even"><td>**REQUEST**

</td><td> </td></tr><tr class="row-odd"><td>JSON Body

</td><td>В тілі запиту в текстовому вигляді опціонально може передаватись коментар до заявки на участь (для Організатора)

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** (json) передаються дані заявки на участь в закритому аукціоні (об’єкт [Access](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-access-dani-zapitu-na-ucast-v-zakritomu-aukcioni)).

# Запросити компанії взяти участь в тендері (Організатор) POST /api/v1/tender/auction/access/invite

За допомогою даного методу можливо запрошувати до участі в тендері як **зареєстровані** в сервісі компанії, так і **незареєстровані**. Після успішного виконання запиту:

<div class="admonition attention" id="bkmrk-%D0%B7%D0%B0%D1%80%D0%B5%D1%94%D1%81%D1%82%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B0%C2%A0%D0%B2-%D1%81%D0%B5%D1%80%D0%B2"><dl class="simple"><dd>- **зареєстрована** в сервісі компанія додається в Учасники тендера, а користувачам цієї компанії відправляється повідомлення на e-mail з посиланням на тендер;
- **незареєстрованій** в сервісі компанії на вказаний e-mail відправляється запрошення на [реєстрацію](https://wiki-v2.edin.ua/books/zagalni-instrukciyi-po-roboti-na-web-FwR/page/rejestraciia) на платформі EDIN 2.0 та посиланням на тендер.

</dd></dl></div>**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default"><colgroup><col></col><col></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/auction/access/invite**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**auction\_id** (обов’язково) long - ідентифікатор тендера

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr><tr class="row-even"><td>**REQUEST**

</td><td> </td></tr><tr class="row-odd"><td>JSON Body

</td><td>В тілі запиту передаються у вигляді масиву об’єктів (по кожній запрошеній компанії):

- **email** (обов’язково) - електронна пошта компанії;
- **code** (обов’язково) - ЄДРПОУ/ІПН компанії, яка запрошується до участі у аукціоні;
- **add** (опціонально) boolean:
    
    <div>
    - true (за замовчуванням) - компанія додається до учаті у аукціоні;
    - false - компанія не додається, лише отримує лист-запрошення на пошту.
    
    </div>**Приклад запиту:**

```json
[
  {"email": "test@edin.ua", "code": "999321453"},
  {"email": "test2@edin.ua", "code": "4343434", "add": true}
]
```

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** передається об’єкт з **access** / **invites** масивами.

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

```json
{
  "access": ["999321453"],
  "invites": ["test2@edin.ua"]
}
```

де

<div class="document" id="bkmrk-access%C2%A0--%D0%BC%D0%B0%D1%81%D0%B8%D0%B2-%D0%84%D0%94%D0%A0%D0%9F%D0%9E" itemscope="itemscope" itemtype="http://schema.org/Article" role="main"><div itemprop="articleBody"><div class="section" id="bkmrk-access%C2%A0--%D0%BC%D0%B0%D1%81%D0%B8%D0%B2-%D0%84%D0%94%D0%A0%D0%9F%D0%9E-1">- **access** - масив ЄДРПОУ/ІПН компаній-Учасників, що були запрошені до вказаного тендера (компанії були **зареєстровані**);
- **invites** - масив e-mail адрес, на які відправляється запрошення на [реєстрацію](https://wiki-v2.edin.ua/books/zagalni-instrukciyi-po-roboti-na-web-FwR/page/rejestraciia).

</div></div></div>

# Завершити тендер (Організатор) PATCH /api/v1/tender/auctions/close

<p class="callout info">Завершити достроково можливо лише активний (опублікований) тендер. Завершити тендер може лише Організатор, що його створив, та «Супер адміністратор» акаунта цього Організатора.</p>

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 78.4524%;"><colgroup><col style="width: 23.5078%;"></col><col style="width: 76.4513%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>PATCH

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/auctions/close**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**auction\_id** (обов’язково) String - ідентифікатор тендера

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

</div>**RESPONSE**

Код сервера 200 (ok).

# Отримати список тендерів для неавторизованого користувача GET /api/v1/tender/guest/auctions/all

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 78.3333%;"><tbody><tr class="row-odd"><td style="width: 25.4876%;">**URL**

</td><td style="width: 74.4681%;"> </td></tr><tr class="row-even"><td style="width: 25.4876%;">Метод запиту

</td><td style="width: 74.4681%;">GET

</td></tr><tr class="row-odd"><td style="width: 25.4876%;">URL запиту

</td><td style="width: 74.4681%;">**/api/v1/tender/guest/auctions/all**

</td></tr><tr class="row-even"><td style="width: 25.4876%;">URL параметри

</td><td style="width: 74.4681%;">Можливо додати [фільтр](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-filter-dodatkovi-parametri-viborki) (опціональні параметри)

</td></tr><tr class="row-odd"><td style="width: 25.4876%;">**Headers**

</td><td style="width: 74.4681%;"> </td></tr><tr class="row-even"><td style="width: 25.4876%;">Authorization

</td><td style="width: 74.4681%;">**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 25.4876%;">Content-Type

</td><td style="width: 74.4681%;">application/json

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** передається масив тендерів (масив об’єктів [Auction](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-auction-dani-tendera)).

# Отримати дані про перегляди тендера (за id) GET /api/v1/tender/auction/views

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 79.2857%;"><tbody><tr class="row-odd"><td style="width: 23.9601%;">**URL**

</td><td style="width: 76.1372%;"> </td></tr><tr class="row-even"><td style="width: 23.9601%;">Метод запиту

</td><td style="width: 76.1372%;">GET

</td></tr><tr class="row-odd"><td style="width: 23.9601%;">URL запиту

</td><td style="width: 76.1372%;">**/api/v1/tender/auction/views**

</td></tr><tr class="row-even"><td style="width: 23.9601%;">URL параметри

</td><td style="width: 76.1372%;">**auction\_id** (обов’язково) long - ідентифікатор тендера

</td></tr><tr class="row-odd"><td style="width: 23.9601%;">**Headers**

</td><td style="width: 76.1372%;"> </td></tr><tr class="row-even"><td style="width: 23.9601%;">Authorization

</td><td style="width: 76.1372%;">**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 23.9601%;">Content-Type

</td><td style="width: 76.1372%;">application/json

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** передаються [дані про перегляди вказаного тендера](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-auctionview-dani-pro-peregliadi-tendera) (масив об’єктів **AuctionView**).

# Отримати список з «Усі тендери» GET /api/v1/tender/auctions/all

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 96.7857%;"><colgroup><col style="width: 16.3759%;"></col><col style="width: 83.5995%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/auctions/all**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**company\_id** (обов’язково) long - ідентифікатор компанії, від якої здійснюється запит

Можливо додати [фільтр](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-filter-dodatkovi-parametri-viborki) (опціональні параметри)

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** передається масив тендерів (масив об’єктів [Auction](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-auction-dani-tendera) ).

# Отримати список тендерів з «Мої тендери» GET /api/v1/tender/auctions/my

<p class="callout info">В «Моїх тендерах» відображаються аукціони, які даний користувач створив чи приймає/приймав участь (робив ставку, робив запит на запрошення в тендер чи був запрошений Організатором). Для Супер адміністратора в «Моїх тендерах» відображається така ж інформація, але по відношенню до всіх користувачів акаунту.</p>

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 97.7381%;"><colgroup><col style="width: 16.9817%;"></col><col style="width: 82.9888%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/auctions/my**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**company\_id** (обов’язково) long - ідентифікатор компанії, від якої здійснюється запит

Можливо додати [фільтр](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-filter-dodatkovi-parametri-viborki) (опціональні параметри)

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** передається масив тендерів (масив об’єктів [Auction](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-auction-dani-tendera) ).

# Отримати список тендерів з «Чернеток» GET /api/v1/tender/auctions/drafts

<p class="callout info">В «Чернетках» відображаються неопубліковані тендери, що були створені даним користувачем. Для Супер адміністратора в «Чернетках» відображається така ж інформація, але відносно всіх користувачів акаунту.</p>

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 79.7619%;"><colgroup><col style="width: 19.4335%;"></col><col style="width: 80.686%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/auctions/drafts**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>Можливо додати [фільтр](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-filter-dodatkovi-parametri-viborki) (опціональні параметри)

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** передається масив тендерів (масив об’єктів [Auction](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-auction-dani-tendera)).

# Отримати дані тендера (за id) GET /api/v1/tender/auction

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 78.6905%;"><colgroup><col style="width: 19.6961%;"></col><col style="width: 80.2736%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/auction**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**auction\_id** (обов’язково) long - ідентифікатор тендера

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** передаються [дані вказаного тендера](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-auction-dani-tendera) (об’єкт **Auction**).

# Опублікувати тендер PATCH /api/v1/tender/auctions/publish

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 79.0476%;"><colgroup><col style="width: 20.204%;"></col><col style="width: 79.7659%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>PATCH

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/auctions/publish**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**auction\_id** (обов’язково) String - ідентифікатор тендера

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki.edin.ua/uk/latest/API_Tender/Methods/Authorization.html)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

</div>**RESPONSE**

Код сервера 200 (ok).

# Створити новий тендер (чернетку) POST /api/v1/tender/auctions

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 97.7381%;"><colgroup><col style="width: 15.7293%;"></col><col style="width: 84.2463%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/auctions**

</td></tr><tr class="row-even"><td>**Headers**

</td><td> </td></tr><tr class="row-odd"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-even"><td>Content-Type

</td><td>application/json

</td></tr><tr class="row-odd"><td>**REQUEST**

</td><td> </td></tr><tr class="row-even"><td>JSON Body

</td><td>В тілі запиту обов’язково передаються [дані нового тендера](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-auction-dani-tendera) (об’єкт Auction)

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** передаються [дані створеного тендера](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-auction-dani-tendera) (об’єкт Auction).

# Видалити ставку по лоту тендера (Організатор) DELETE /api/v1/tender/lot/bets

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-d"><table class="colwidths-given docutils align-default" style="width: 97.1429%;"><colgroup><col style="width: 16.5632%;"></col><col style="width: 83.4122%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>DELETE

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/lot/bets**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**lot\_id** (обов’язково) long - ідентифікатор лоту тендера

**auction\_id** (обов’язково) long - ідентифікатор тендера

**bet\_id** (обов’язково) long - ідентифікатор ставки

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr><tr class="row-even"><td>**REQUEST**

</td><td> </td></tr><tr class="row-odd"><td>JSON Body

</td><td>В тілі запиту обов’язково передається причина видалення ставки (text)

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** (json) передається коротке інфо по видаленій ставці (об’єкт):

```json
{"removedBet":96,"comment":"Причина: погода","newBest":357}
```

де

- removedBet - ідентифікатор видаленої ставки;
- comment - коментар (причина видалення);
- newBest - краща поточна ставка по лоту.

# Зробити ставку по лоту (Учасник) POST /api/v1/tender/lot/bets

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 97.8571%;"><colgroup><col style="width: 16.1984%;"></col><col style="width: 83.7772%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/v1/tender/lot/bets**

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**lot\_id** (обов’язково) long - ідентифікатор лоту тендера

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr><tr class="row-even"><td>**REQUEST**

</td><td> </td></tr><tr class="row-odd"><td>JSON Body

</td><td>В тілі запиту передається об’єкт:

{"value":42,"comment":"Коментар2","companyId":447}, де

- value - значення ставки;
- comment - коментар (опціонально);
- companyId - ідентифікатор компанії учасника, що робить ставку

</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** (json) передаються дані зробленої ставки (об’єкт [Bet](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-bet-dani-stavki-po-tenderu)).

# Вибір доступних користувачів по компанії GET /api/v1/tender/users

**REQUEST**

<div align="left" dir="ltr" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table style="width: 82.8571%; height: 385.6px;"><colgroup><col style="width: 18.9655%;" width="132"></col><col style="width: 80.8908%;" width="563"></col></colgroup><tbody><tr style="height: 29.6px;"><td style="height: 29.6px;">**URL**

</td><td style="height: 29.6px;"></td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">Метод запиту

</td><td style="height: 29.6px;">GET

</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">URL запиту

</td><td style="height: 29.6px;">**/api/v1/tender/users**

</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">**Headers**

</td><td style="height: 29.6px;"> </td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;">Authorization

</td><td style="height: 35.2px;">**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">Content-Type

</td><td style="height: 29.6px;">application/json

</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">**REQUEST**

</td><td style="height: 29.6px;"> </td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">JSON Body

</td><td style="height: 29.6px;">  
</td></tr></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** передаються ідентифікатори користувачів у вигляді масиву об'єктів. Також може бути присутня й інша інформація, яка стосується користувача та акаунта.

**JSON приклад відповіді:**

```json
[
  {
       "id": 60214599 // ID користувача
  },
]
```

# Надати доступ користувачам до вже опублікованого тендера POST /api/v1/tender/auction/users

**REQUEST**

<div align="left" dir="ltr" id="bkmrk-url-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-pos"><table><colgroup><col width="132"></col><col width="563"></col></colgroup><tbody><tr><td>**URL**

</td><td></td></tr><tr><td>Метод запиту

</td><td>POST

</td></tr><tr><td>URL запиту

</td><td>**/api/v1/tender/auction/users**

</td></tr><tr><td>URL параметри

</td><td>**auction\_id** (обов'язково) - вказується id аукціону, до якого треба надати доступ

</td></tr><tr><td>**Headers**

</td><td> </td></tr><tr><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr><td>Content-Type

</td><td>application/json

</td></tr><tr><td>**REQUEST**

</td><td></td></tr><tr><td>JSON body

</td><td>\[users\] - масив ідентифікаторів користувачів, яким потрібно надати доступ

</td></tr></tbody></table>

</div>**RESPONSE**

Код сервера 200 (ok).

# Закрити доступ до вже опублікованого тендера DELETE /api/v1/tender/auction/users

**REQUEST**

<div align="left" dir="ltr" id="bkmrk-url-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-del"><table><colgroup><col width="132"></col><col width="563"></col></colgroup><tbody><tr><td>**URL**

</td><td></td></tr><tr><td>Метод запиту

</td><td>DELETE

</td></tr><tr><td>URL запиту

</td><td>**/api/v1/tender/auction/users**

</td></tr><tr><td>URL параметри

</td><td>**auction\_id** (обов'язково) - вказується id аукціону, до якого треба закрити доступ

</td></tr><tr><td>**Headers**

</td><td> </td></tr><tr><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr><td>Content-Type

</td><td>application/json

</td></tr><tr><td>**REQUEST**

</td><td></td></tr><tr><td>JSON body

</td><td>\[users\] - масив ідентифікаторів користувачів, яким потрібно закрити доступ

</td></tr></tbody></table>

</div>**RESPONSE**

Код сервера 200 (ok).