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

Endpoint

Parameters

Authorization

Не е необходима регистрация или токен.

Лимит: до 60 заявки на час от един IP адрес.

Изпратената информация не се записва никъде.

Request

POST /api/egn/validate
Host: egn.bg
Accept: application/json
Content-Type: application/x-www-form-urlencoded

egn=7207014773

Response

Валидно ЕГН:

{
  "valid": true,
  "result": {
    "data": {
      "year": 1972,
      "month": "07",
      "day": "01",
      "birthday_text": "1 юли 1972 г.",
      "birthday_iso": "1972-07-01",
      "age": 53,
      "region_num": "477",
      "sex": 1,
      "sex_text": "жена",
      "region_text": "Пловдив",
      "birthnumber": 21,
      "zodiac": {
        "sign": "Рак",
        "range": "21 юни - 22 юли"
      },
      "famous": [
        {
          "name": "Анелия",
          "year": 1982
        },
        {
          "name": "Юлиян Радионов",
          "year": 1979
        }
      ]
    },
    "compiled": "<div class=\"egn-info\"><dl class=\"row mb-0\"><dt class=\"col-12 col-md-4\"><strong>ЕГН</strong></dt><dd class=\"col-12 col-md-8 mb-2\">7207014773</dd><dt class=\"col-12 col-md-4\"><strong>Пол</strong></dt><dd class=\"col-12 col-md-8 mb-2\"><span class=\"badge bg-primary\">жена</span></dd><dt class=\"col-12 col-md-4\"><strong>Дата на раждане</strong></dt><dd class=\"col-12 col-md-8 mb-2\">1 юли 1972 г. <small class=\"text-muted\">(събота)</small> <small class=\"text-muted\">(1972-07-01)</small></dd><dt class=\"col-12 col-md-4\"><strong>Възраст</strong></dt><dd class=\"col-12 col-md-8 mb-2\">53</dd><dt class=\"col-12 col-md-4\"><strong>Регион</strong></dt><dd class=\"col-12 col-md-8 mb-2\">Пловдив</dd><dt class=\"col-12 col-md-4\"><strong>Поредност на раждане</strong></dt><dd class=\"col-12 col-md-8 mb-2\">21</dd><dt class=\"col-12 col-md-4\"><strong>Зодиак</strong></dt><dd class=\"col-12 col-md-8 mb-2\"><span class=\"badge bg-info text-dark\">Рак</span> <small class=\"text-muted\">(21 юни - 22 юли)</small></dd><dt class=\"col-12 col-md-4\"><strong>Известни личности</strong></dt><dd class=\"col-12 col-md-8 mb-2\"><a href=\"https://www.google.com/search?q=%D0%90%D0%BD%D0%B5%D0%BB%D0%B8%D1%8F (1982)\" target=\"_blank\">Анелия (1982)</a>, <a href=\"https://www.google.com/search?q=%D0%AE%D0%BB%D0%B8%D1%8F%D0%BD+%D0%A0%D0%B0%D0%B4%D0%B8%D0%BE%D0%BD%D0%BE%D0%B2 (1979)\" target=\"_blank\">Юлиян Радионов (1979)</a></dd></dl><p class=\"mt-2 mb-0 text-muted small\">7207014773 е ЕГН на жена, родена на 1 юли 1972 г. в Пловдив. <span class=\"text-dark\"><strong>Зодиак:</strong> Рак <small class=\"text-muted\">(21 юни - 22 юли)</small></span></p></div>",
    "narrative": "7207014773 е ЕГН на жена, родена на 1 юли 1972 г. в Пловдив."
  }
}

Грешен формат (не са 10 цифри):

{
  "valid": false,
  "errors": {
    "egn": [
      "ЕГН трябва да съдържа точно 10 цифри."
    ]
  }
}

10 цифри, но невалидно ЕГН:

{
  "valid": false,
  "message": "Въведенето ЕГН не е валидно!"
}

Примери

cURL

curl -X POST https://egn.bg/api/egn/validate \
  -H "Accept: application/json" \
  -d "egn=0000000000"

Python (requests)

import requests

response = requests.post(
    "https://egn.bg/api/egn/validate",
    headers={"Accept": "application/json"},
    data={"egn": "0000000000"}
)
print(response.json())

JavaScript (fetch)

fetch("https://egn.bg/api/egn/validate", {
  method: "POST",
  headers: {
    "Accept": "application/json",
    "Content-Type": "application/x-www-form-urlencoded"
  },
  body: new URLSearchParams({ egn: "0000000000" })
})
.then(res => res.json())
.then(data => console.log(data));

Vue.js

this.$http.post('https://egn.bg/api/egn/validate', 
  new URLSearchParams({ egn: this.egn }), 
  { headers: { Accept: 'application/json' } }
).then(res => {
  console.log(res.data);
});

PHP (cURL)

<?php
$ch = curl_init("https://egn.bg/api/egn/validate");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => "egn=0000000000",
    CURLOPT_HTTPHEADER => ["Accept: application/json"]
]);
$response = curl_exec($ch);
echo $response;
?>