API КВЕД: назва виду діяльності і підкоди за кодом
Оновлено 26.09.2026
Initask API розшифровує код КВЕД у будь-якій формі: секція J, розділ 62, група 62.0 чи клас 62.01. Відповідь містить офіційну назву за класифікатором ДК 009:2010, місце в ієрархії, пояснення Держстату «що включає» і «що не включає», статус для єдиного податку по групах і перелік підкодів. Адреса `GET https://dani.initask.com/v1/kved/{code}`.
Для чого
Розшифровка КВЕД у картці клієнта, вибір виду діяльності у формі реєстрації і перевірка коду з виписки. У реєстрі компанії видно лише цифри, а людині потрібна назва і розуміння, чи можна з цим кодом бути на спрощеній системі.
Параметр
| Параметр | Де | Обовʼязковий | Опис |
|---|---|---|---|
| code | у шляху | так | код КВЕД: літера секції, 2 цифри розділу, група 62.0 або клас 62.01 |
Шлюз терпимий до запису: 62,01 читається як 62.01, літеру секції можна писати малою. Це зручно, коли код приходить з таблиці чи з тексту, де його писали по-різному.
``` curl -H "Authorization: Bearer $INITASK_KEY" "https://dani.initask.com/v1/kved/62.01" ```
Поля відповіді
| Поле | Значення |
|---|---|
| code | код |
| name | назва за ДК 009:2010 |
| level | section, division, group або class |
| section | секція: код і назва |
| division | розділ: код і назва |
| group | група: код і назва |
| includes | що включає, з пояснень Держстату |
| excludes | що не включає і куди це віднесено |
| fop | для класу: статус на єдиному податку, пояснення для 1, 2 і 3 групи, норми ПКУ |
| fop.status | allowed, only3, check, forbidden або na |
| url | сторінка коду на kved.initask.com |
| children | підкоди: код, назва, рівень, сторінка |
Для 62.01 назва «Компʼютерне програмування», секція J «Інформація та телекомунікації», розділ 62. У полі `excludes` видно, куди віднесено суміжну діяльність: видання стандартного програмного забезпечення належить до 58.29.
Статус для єдиного податку
Поле `fop` є лише у класу, найдетальнішого рівня. Воно дає статус і пояснення окремо для 1, 2 і 3 групи з нормами Податкового кодексу. Значення `fop.status`:
- `allowed`: можна на єдиному податку;
- `only3`: лише 3 група;
- `check`: потрібна перевірка умов;
- `forbidden`: на єдиному податку заборонено;
- `na`: статус для цього рівня не визначається.
Для 62.01 це 2 група з умовою щодо клієнтів і 3 група без обмежень. Такий статус зручно показувати у формі реєстрації ФОП одразу після вибору коду.
Ієрархія: навіщо секція, розділ і група
Класифікатор побудований деревом. Секція обʼєднує великі галузі, розділ уточнює напрям, група і клас описують конкретну діяльність. Поле `children` дозволяє йти деревом вниз: запит секції повертає її розділи, запит розділу повертає групи, і так до класу. На цьому легко побудувати вибір виду діяльності у формі реєстрації: людина спершу обирає галузь, потім уточнює, і в кінці отримує точний клас з назвою і статусом для єдиного податку.
Пояснення Держстату з полів `includes` і `excludes` допомагають, коли людина вагається між двома схожими кодами: видно, що саме входить у кожен.
Помилки
| Код | Помилка | Коли |
|---|---|---|
| 400 | bad_request | рядок має форму, відмінну від коду КВЕД |
| 404 | not_found | такого коду у класифікаторі немає |
Джерело, кеш і ліміти
Джерело: класифікатор ДК 009:2010, Держстат, з назвами з набору на data.gov.ua, через kved.initask.com. Класифікатор змінюється рідко, тому відповідь кешується на 1440 хвилин.
| План | Запитів | Ціна, грн на місяць |
|---|---|---|
| Безкоштовний | 100 на добу | 0 |
| Старт | 10000 на місяць | 990 |
| Про | 100000 на місяць | 2990 |
Авторизація заголовком `Authorization: Bearer КЛЮЧ` або параметром `key`, без ключа 100 запитів на добу з однієї IP-адреси. Коли ліміт вичерпано, приходить 429 і заголовок `Retry-After`.
Що робити
- Відкрийте документацію КВЕД і запитайте код своєї основної діяльності.
- Спробуйте секцію, розділ і групу, щоб побачити, як змінюються `level` і `children`.
- У формі ФОП показуйте статус з `fop` поруч з обраним кодом.
- КВЕД компанії беріть з картки за ЄДРПОУ і розшифровуйте цим ендпоінтом.
- Для строків звітності за обраною групою ФОП підключіть податковий календар.
Питання і відповіді
Як отримати назву КВЕД за кодом через API?
Зробіть запит GET https://dani.initask.com/v1/kved/{code}. Відповідь містить назву за ДК 009:2010, ієрархію, пояснення Держстату і підкоди.
Чи можна з цим КВЕД бути на єдиному податку?
Для класу поле fop дає статус і пояснення окремо для 1, 2 і 3 групи з нормами Податкового кодексу. Для 62.01 це 2 група з умовою щодо клієнтів і 3 група без обмежень.
Яку редакцію КВЕД повертає API?
Чинний класифікатор ДК 009:2010 з назвами з набору Держстату на data.gov.ua.