Документація API

Інтегруйте дані з реєстру транспортних засобів (DMR) та реєстру компаній (CVR) Данії у свої застосунки. Один API — два потужних набори даних.

Початок роботи

1
Створіть акаунт

Зареєструйтесь безкоштовно та отримайте API ключ миттєво.

2
Отримайте API ключ

Знайдіть ключ у кабінеті в розділі API Ключі.

3
Надсилайте запити

Надсилайте запити з вашим ключем у заголовку X-API-KEY.

Автентифікація

Усі API запити потребують API ключ, надісланий у заголовку X-API-KEY.

Заголовок 
X-API-KEY: your_api_key_here

API Автомобілів

Знайдіть будь-який автомобіль, зареєстрований у Данії, за VIN-кодом або держ. номером. Отримайте повні технічні характеристики, історію техоглядів, комплектацію, дані про пальне та інше.

✓ Марка, модель, варіант та тип
✓ Дані двигуна: циліндри, к.с., об'єм
✓ Тип пального та витрата
✓ Повна історія техоглядів
✓ Список комплектації
✓ Статус реєстрації та дати
✓ Екологічні дані та викиди
GET /api/v1/vehicles/{ident}

ident — VIN (номер кузова) або реєстраційний номер 

curl -H "X-API-KEY: your_api_key" \
  https://soge.dk/api/v1/vehicles/AB12345

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

200 OK application/json 
{
  "data": {
    "vehicle": {
      "koeretoej_ident": "9000012345",
      "stel_nummer": "WVWZZZ3CZWE123456",
      "registrering_nummer": "AB12345",
      "brand": "Volkswagen",
      "model": "Golf",
      "variant": "1.4 TSI Comfortline",
      "type": "Personbil",
      "status": "Registreret",
      "first_registration": "2020-03-15",
      "color": null,
      "total_weight": 1785,
      "curb_weight": 1310,
      "seats": 5,
      "doors": 4,
      "motor": {
        "cylinders": 4,
        "displacement": 1395,
        "max_power_kw": 110,
        "max_power_hp": 150,
        "max_rpm": 5000,
        "mileage": 87432
      },
      "fuel": {
        "type": "Benzin",
        "consumption_mixed": 5.2,
        "consumption_city": 6.8,
        "consumption_highway": 4.3,
        "co2_emission": 120
      },
      "environment": {
        "emission_norm": "Euro 6",
        "particle_filter": true
      }
    },
    "equipment": [
      "ABS", "Airbag", "Klimaanlaeg",
      "Fartpilot", "Parkeringssensor"
    ],
    "syn": [
      {
        "date": "2024-03-10",
        "result": "Godkendt",
        "mileage": 87432
      },
      {
        "date": "2022-03-05",
        "result": "Godkendt",
        "mileage": 54210
      }
    ],
    "permissions": []
  }
}

API Компаній

Шукайте данські компанії за CVR-номером або назвою. Отримайте дані про компанію, коди галузей, працівників, засновників та інше з офіційного реєстру CVR.

✓ Назва, форма та статус компанії
✓ CVR-номер та P-номери
✓ Коди галузей (основна та додаткова)
✓ Кількість працівників та інтервали
✓ Дані засновників та учасників
✓ Адреса та контактна інформація
✓ Життєвий цикл та історія компанії
GET /api/v1/companies/{search_term}

search_term — номер CVR або назва компанії 

curl -H "X-API-KEY: your_api_key" \
  https://soge.dk/api/v1/companies/12345678

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

200 OK application/json 
{
  "data": {
    "hits": {
      "total": { "value": 1 },
      "hits": [
        {
          "_source": {
            "Vrvirksomhed": {
              "cvrNummer": 12345678,
              "virksomhedMetadata": {
                "nyesteNavn": {
                  "navn": "Example ApS"
                },
                "nyesteVirksomhedsform": {
                  "langBeskrivelse": "Anpartsselskab"
                },
                "nyesteHovedbranche": {
                  "branchekode": "620100",
                  "branchetekst": "Computerprogrammering"
                },
                "nyesteBeliggenhedsadresse": {
                  "vejnavn": "Vestergade",
                  "husnummerFra": 10,
                  "postnummer": 1456,
                  "postdistrikt": "Copenhagen K"
                }
              },
              "virksomhedsstatus": [
                {
                  "status": "NORMAL"
                }
              ],
              "deltagerRelation": [
                {
                  "deltager": {
                    "navne": [
                      { "navn": "John Doe" }
                    ]
                  }
                }
              ]
            }
          }
        }
      ]
    }
  }
}

Обмеження запитів

Free Безкоштовно: 3 зап./хв, 1 000 зап./день
Standard Стандарт: 120 зап./хв, 10 000 зап./день
Business Бізнес: 600 зап./хв, 100 000 зап./день
Потрібно більше запитів? Покращіть план

Коди помилок

200 OK — Запит виконано
401 Не авторизовано — недійсний або відсутній ключ API
403 Заборонено — ключ API неактивний
404 Не знайдено — авто або компанію не знайдено
429 Забагато запитів — перевищено ліміт

Сценарії інтеграції

🚗 Сайт авто-дилера Показуйте повну історію авто (DMR, ТО, пробіг, страховка, відкликання) на кожному оголошенні за VIN/номером.
🏢 CRM / бухгалтерія Автозаповнення даних компанії з CVR — назва, адреса, статус, власники, фінанси — при додаванні клієнта.
🔍 Перевірка контрагента Ризик-перевірка компанії перед угодою: статус, банкрутства власників, мережа звʼязків і ризиків.
🔔 Моніторинг і сповіщення Відстежуйте зміни авто чи компаній (власник, статус) у вашому портфелі.

Часті питання

Як отримати API-ключ?
Зареєструйте безкоштовний акаунт, відкрийте кабінет і згенеруйте ключ. Надсилайте його у заголовку X-API-KEY.
Які ліміти запитів?
За планом: Free, Standard і Business — див. розділ «Ліміти» вище. Підвищення будь-коли.
Які формати запиту приймаються?
Авто: 17-значний VIN або номерний знак (напр. AB12345). Компанії: 8-значний CVR або текстова назва.
Чи можна комерційно?
Так — на платних планах. Дані з офіційних реєстрів Данії (DMR, CVR).
Наскільки свіжі дані?
Дані авто оновлюються з DMR-ETL (щотижня); дані компаній (CVR) — наживо.
Чи є безкоштовний тест?
Так — план Free дозволяє спробувати всі ендпоінти в межах ліміту, без картки.

Перевірка стану

GET /api/v1/health Без авторизації 
{ "status": "healthy", "service": "Soge.dk API", "version": "1.0.0" }