Поиск и получение данных об организации по ИНН

Реквизиты организации возвращает запрос по ИНН:

• метод: GET
• ресурс: /v3/filter/api/counterparty-detail
• тело ответа — коллекция объектов Counterparty в свойстве data

В запросе есть обязательный параметр vatNumber — ИНН.

Метод нужен, чтобы подставить реквизиты плательщика в заказ, не заставляя покупателя вводить их руками: по ИНН возвращаются наименование, КПП и адреса, которые затем уходят в создание заказа.

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

HTTP

GET /v3/filter/api/counterparty-detail?vatNumber=2323232323
Accept: application/json
User-Agent: MyApp 1.0
Authorization: Bearer b37c4c689295904ed21eee5d9a48d42e

CURL

curl -L -X GET '{baseUrl}/v3/filter/api/counterparty-detail?vatNumber=2323232323' \
  -H 'Accept: application/json' \
  -H 'User-Agent: MyApp 1.0' \
  -H 'Authorization: Bearer b37c4c689295904ed21eee5d9a48d42e'

GET /v3/filter/api/counterparty-detail
Authorization: Bearer b37c4c689295904ed21eee5d9a48d42e
Content-Type: application/json
User-Agent: MyApp 1.0
Accept: application/json

{
  "data": [
    {
      "id": "01771534-196a-1105-839a-82422289d6d9",
      "vatNumber": "7736207543",
      "taxRegistrationReasonCode": "773601001",
      "name": "ООО «Ромашка»",
      "nameFull": "Общество с ограниченной ответственностью «Ромашка»",
      "registrationNumber": "1027700123456",
      "registrationDate": "2026-09-07T00:00:00+03:00",
      "registrationAddress": "119021, г. Москва, ул. Тимура Фрунзе, д. 11",
      "postAddress": "119021, г. Москва, ул. Тимура Фрунзе, д. 11",
      "postAddressZip": "119021"
    }
  ],
  "metaData": {
    "totalCount": 1,
    "pageSize": 20,
    "page": 1
  }
}

Counterparty