Корпоративное API: Получить список представителей в Астрал.Доверенность | Помощь Астрал
Техподдержка:
8 (800) 551-80-36

Техподдержка
Отдел продаж
8 (800) 600-36-51

moscow@astral.ru
График работы

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

Автор Прошин Алексей

Автор: Прошин Алексей

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

Описание

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