egrul_ip — Проверка статуса ИП / сведений ЕГРИП¶

POST https://api.newdb.net/v2

Метод выполняет поиск сведений об индивидуальном предпринимателе по innfiz через источник ФНС "Прозрачный бизнес".

Для запроса нужно передавать innfiz из 12 цифр.

Заголовки¶

Content-Type: application/json
X-API-KEY: <your_token>

Входная схема (request)¶

{
  "params": {
    "innfiz": "string (ИНН физлица, 12 цифр)",
    "country": "string (ru)",
    "method": "egrul_ip"
  },
  "webhook": "https://your.host/whook",
  "requestId": "optional-string"
}

Пример запроса¶

POST /v2 HTTP/1.1
Host: api.newdb.net
Content-Type: application/json
X-API-KEY: YOUR_TOKEN

{
  "params": {
    "innfiz": "270392288605",
    "country": "ru",
    "method": "egrul_ip"
  },
  "requestId": "df5f4a21-2d3c-4de7-9a8d-455b89990011"
}

Пример ответа¶

{
  "params": {
    "innfiz": "270392288605",
    "country": "ru",
    "method": "egrul_ip"
  },
  "requestId": "df5f4a21-2d3c-4de7-9a8d-455b89990011",
  "datecreated": "2026-03-20 07:12:31",
  "state": "complete",
  "balance": 9707,
  "tasks": 1,
  "is_repeat": false,
  "results": {
    "egrul_ip": {
      "taskId": "0b8cb1c6-67bf-4f3f-b2ba-2b2d205f3d53",
      "dateupdated": "2026-03-20 07:12:45",
      "result": {
        "status": 200,
        "data": []
      }
    }
  }
}

Что приходит при найденных данных¶

Если ИП найден, элемент в results.egrul_ip.result.data[] имеет ту же верхнеуровневую структуру, что и метод egrul: request, http, search, company.

В блоке search.matches[] обычно возвращаются ИНН, ОГРНИП, краткое и полное имя, статус, дата регистрации, коды ОКВЭД и ссылки на карточку в "Прозрачном бизнесе".

x-ai (метаданные для AI)¶

{
  "tools": [
    {
      "name": "egrul_ip",
      "description": "Получение сведений об ИП и статуса ЕГРИП по ИНН физического лица через Прозрачный бизнес.",
      "input_schema": {
        "innfiz": "string — ИНН физического лица, 12 цифр",
        "country": "string (ru)",
        "method": "string (egrul_ip)",
        "webhook": "string (URL, optional)",
        "requestId": "string (optional)"
      },
      "output_schema": {
        "state": "string (complete|processing|error)",
        "results": {
          "egrul_ip": {
            "taskId": "string",
            "dateupdated": "string",
            "result": {
              "status": "number",
              "data": "array — сведения ЕГРИП / ИП"
            }
          }
        }
      },
      "headers_required": ["X-API-KEY"]
    }
  ],
  "policy": "Если пользователь хочет проверить статус ИП или сведения ЕГРИП по ИНН физлица, используй метод egrul_ip."
}