# Отримання документа компанії GET /api/external/company/form

##### **REQUEST**

<div class="wy-table-responsive" 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-get"><table class="colwidths-given docutils align-default" style="width: 97.2619%;"><colgroup><col style="width: 22.2824%;"></col><col style="width: 77.6874%;"></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/external/company/form**

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

</td><td>**companyCode** (обов’язково) - код Компанії;

**formType** (обов’язково) - Enum name з `ESSRegFormType`, наприклад, `OFFER_AGREEMENT_MANAGER`.

**format** (опційно) - `binary` або `base64`. Default: `binary`.

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

</td><td>  
</td></tr><tr><td>Auth type

</td><td>API key</td></tr><tr><td>Key / Value

</td><td>**x-system-id** - токен, отриманий при підключенні</td></tr><tr class="row-odd"><td>**Headers**

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

</td><td>application/json

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

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

В тілі **відповіді** передається:

- статус 200, якщо `format=binary`

PDF bytes з content type:

```
Content-Type: application/pdf
```

- статус 200, якщо `format=base64`

```
{
  "formType": "OFFER_AGREEMENT_MANAGER",
  "fileName": "Договір-оферта (керівник/УО).pdf",
  "contentType": "application/pdf",
  "contentBase64": "JVBERi0x..."
}
```

<table id="bkmrk-%D0%9F%D0%BE%D0%BB%D0%B5-%D0%A2%D0%B8%D0%BF-%D0%9E%D0%BF%D0%B8%D1%81-formty" style="width: 67.7381%;"><thead><tr><th style="width: 32.7154%;">Поле</th><th style="width: 14.7219%;">Тип</th><th style="width: 52.5264%;">Опис</th></tr></thead><tbody><tr><td style="width: 32.7154%;">`formType`</td><td style="width: 14.7219%;">string</td><td style="width: 52.5264%;">Enum name документа.</td></tr><tr><td style="width: 32.7154%;">`fileName`</td><td style="width: 14.7219%;">string</td><td style="width: 52.5264%;">Імʼя файлу.</td></tr><tr><td style="width: 32.7154%;">`contentType`</td><td style="width: 14.7219%;">string</td><td style="width: 52.5264%;">Завжди `application/pdf`.</td></tr><tr><td style="width: 32.7154%;">`contentBase64`</td><td style="width: 14.7219%;">string</td><td style="width: 52.5264%;">PDF у base64.</td></tr></tbody></table>

##### **CURL binary**

```
curl -X GET 'https://host/api/external/company/form?...' \
  -H 'x-system-id: 019eb581-307b-7562-8a1f-20227511e898' \
  -o company-form.pdf
```

##### **CURL base 64**

```
curl -X GET 'https://host/api/external/company/form?...' \
  -H 'x-system-id: 019eb581-307b-7562-8a1f-20227511e898'
```

##### **Помилки**

<table id="bkmrk-http-type-%D0%9E%D0%BF%D0%B8%D1%81-400-u" style="width: 69.4048%;"><thead><tr><th style="width: 12.1951%;">HTTP</th><th style="width: 41.2229%;">`type`</th><th style="width: 46.7193%;">Опис</th></tr></thead><tbody><tr><td style="width: 12.1951%;">400</td><td style="width: 41.2229%;">`unknown_form_type`</td><td style="width: 46.7193%;">Невідомий `formType`.</td></tr><tr><td style="width: 12.1951%;">400</td><td style="width: 41.2229%;">`form_not_found`</td><td style="width: 46.7193%;">Документ не знайдений.</td></tr><tr><td style="width: 12.1951%;">400</td><td style="width: 41.2229%;">`unknown_format`</td><td style="width: 46.7193%;">`format` не `binary` і не `base64`.</td></tr><tr><td style="width: 12.1951%;">403</td><td style="width: 41.2229%;">`company_access_denied`</td><td style="width: 46.7193%;">Немає доступу до company.</td></tr></tbody></table>