Корпоративное API: Получить список представителей в Астрал.Доверенность | Помощь Астрал
Техподдержка:
Отдел продаж
График работы

Астрал.Доверенность: Получить список представителей

Автор Технический писатель Астрал

Автор: Технический писатель Астрал

13.08.2025
25
Из статьи вы узнаете:

Описание

GET/corporate-api/v1/representative-templates

Данный метод позволяет получить список представителей организации

Входные параметры

Наименование параметраТип параметраЗначениеДополнительно
SortField

string (query)

Поле, по которому нужно отсортировать списоксортировка происходит только по полю displayName по алфавиту
SortOrder

string (query)

Порядок сортировки

Available values : Asc, Desc

Searchstring (query)Значение для поиска

поиск происходит только по следующим значениям:

  • displayName 
  • inn 

  • kpp 

Offset

integer($int32)

(query)

отступ
Count

integer($int32)

(query)

количество

Ответ

КодЗначениеДополнительно
200

Success

{
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "displayName": "string",
      "representativeType": "Organization",
      "inn": "string",
      "kpp": "string"
    }
  ],
  "meta": {
    "totalCount": 0
  }
}

Возвращается массив представителей data, содержащий следующие значения:

  • id - идентификатор представителя
  • displayName - наименование представителя
  • representativeType - тип представителя

  • inn - инн представителя

  • kpp - кпп представителя

  • meta - служебная информация
    • totalCount - общее число найденных шаблонов


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

/corporate-api/v1/representative-templates

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

{
    "data": [
        {
            "id": "1c8d2b09-12d0-4caa-818d-34f3bc409212",
            "displayName": "Иванов Иван Васильевич",
            "representativeType": "PrivatePerson",
            "inn": "962759252881"
        },
        {
            "id": "d8274ead-2127-4f7b-8cd7-ddc05a29e1ad",
            "displayName": "ООО ТЕСТ",
            "representativeType": "Organization",
            "inn": "9636561953",
            "kpp": "111111111"
        },
        {
            "id": "ba4339d0-e3bd-4b80-b234-6c8e8b17be61",
            "displayName": "Петров Василий Николаевич",
            "representativeType": "IndividualEntrepreneur",
            "inn": "965889853102"
        }
    ],
    "meta": {
        "totalCount": 3
    }
}

Комментарии для сайта Cackle
Получите электронную подпись для работы на госпорталах, для участия в торгах и ЭДО

Хотите разобраться
в сервисах Астрал?

Подробные инструкции,
решения проблем
и ответы на вопросы
в Базе знаний

autohello-finger