API проверка на ЕГН

Проверка на структура, дата и контролна цифра с една POST заявка.

POSThttps://egn.bg/api/egn/validate
Без API ключ60 заявки / минута / IPJSON отговор

egn — задължителен текстов низ с точно 10 цифри. Изпращайте го като текст, за да запазите водещите нули. Поддържат се JSON и form-urlencoded заявки.

Заявка

cURL
curl https://egn.bg/api/egn/validate \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"egn":"8507247504"}'
JavaScript
const response = await fetch(
  'https://egn.bg/api/egn/validate', {
    method: 'POST',
    headers: {
      'Accept': 'application/json',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ egn: '8507247504' })
  }
);
const data = await response.json();
PHP
<?php
$ch = curl_init('https://egn.bg/api/egn/validate');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'egn' => '8507247504'
    ])
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);
Python
import requests

response = requests.post(
    'https://egn.bg/api/egn/validate',
    headers={'Accept': 'application/json'},
    json={'egn': '8507247504'},
    timeout=10
)
data = response.json()

Примерът за Python използва requests.

Отговор 200 · съкратен пример

JSON
{
  "valid": true,
  "result": {
    "data": {
      "birthday_iso": "1985-07-24",
      "sex_text": "мъж",
      "region_num": "750",
      "region_text": "София - окръг"
    }
  }
}

valid: true потвърждава структурата и контролната цифра, а не че ЕГН е действително издаден.

Какви данни съдържа пълният отговор?

result.data — дата (year, month, day, birthday_text, birthday_iso), възраст (age), пол (sex, sex_text), регион (region_num, region_text), поредност (birthnumber), зодия (zodiac) и личности, родени на същата дата (famous).

result.compiled — готов HTML блок. result.narrative — текстово описание. famous е списък или null; възрастта се изчислява към момента на заявката.

Невалидни данни и ограничения

200 10 цифри, но невалидна дата или контролна цифра
Невалидно ЕГН
{
  "valid": false,
  "message": "Въведенето ЕГН не е валидно!"
}
422 Липсващо поле или грешен формат
Грешен формат
{
  "valid": false,
  "errors": {
    "egn": ["ЕГН трябва да съдържа точно 10 цифри."]
  }
}
429 Надвишен лимит на заявките

Изчакайте времето от HTTP заглавката Retry-After, преди да изпратите следваща заявка.

Всички инструменти

Полезни онлайн инструменти за работа с ЕГН и свързани справки.