Перейти к основному содержанию
GET
curl
Эндпоинт Get an Account возвращает один счёт с его идентификаторами, владельцами, актуальностью синхронизации и охватом истории. sync.last_synced_at указывает, когда Didit в последний раз получил данные из банка. Для получения полных идентификаторов на вашем ключе должно быть разрешение на доступ к банковским данным. См. Счета, балансы и транзакции.

Авторизации

x-api-key
string
header
обязательно

API-ключ вашего приложения берётся в разделе Developers -> API keys в Business Console. Основной ключ имеет полный доступ. Именованный ключ можно ограничить: доступ для каждого ресурса (нет доступа, только чтение или запись), ограничение некоторыми сценариями или одобренными сессиями, список IP-адресов и дата истечения срока. Ответ 401 означает, что ключ неверный, отозван или истёк. Ответ 403 означает, что ключ не передан, у ключа нет доступа к этому ресурсу или действию либо запрос пришёл с адреса вне его списка IP. Ответ 404 на маршруте сессии означает, что сессия находится вне сценариев или статусов, доступных ключу. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без права записи в сессии получает ссылки и токены сессий как null. См. https://docs.didit.me/console/api-keys.

Параметры пути

account_id
string<uuid>
обязательно

Идентификатор счёта.

Ответ

Счёт.

Один счет внутри подключения.

id
string<uuid>
обязательно

Идентификатор счёта. Принадлежит подключению и не меняется, пока существует, включая продления.

connection_id
string<uuid>
обязательно
name
string | null
обязательно
product
string | null
обязательно

Название продукта банка.

type
enum<string>
обязательно
Доступные опции:
current,
savings,
card,
loan,
investment,
other
usage
enum<string>
обязательно
Доступные опции:
personal,
business,
unknown
currency
string
обязательно

Код валюты по ISO 4217.

Pattern: ^[A-Z]{3}$
holder_name
string | null
обязательно

Имя владельца, если банк его передаёт.

holders
object[]
обязательно

Владельцы, которых передаёт банк. При подсчёте владельцев учитываются только holder и joint_holder.

identifiers
object
обязательно

Полные идентификаторы, возвращаемые серверным клиентам с разрешением на доступ к банковским данным.

account_ref
string | null
обязательно

Идентифицирует один и тот же банковский счёт в разных подключениях одного приложения и среды: хеш с ключом от идентификаторов самого банка. null, если банк не предоставляет надёжного идентификатора. Используйте его, чтобы распознать банковский счёт, который вам уже известен.

account_ref_previous
string | null
обязательно

Предыдущий account_ref, только для подтверждённого псевдонима, например при миграции банка.

status
enum<string>
обязательно

access_removed: пользователь удалил счет из согласия. Синхронизация для него больше не выполняется.

Доступные опции:
open,
closed,
access_removed
scopes_granted
enum<string>[]
обязательно
Доступные опции:
accounts,
balances,
transactions
sync
object
обязательно
history_coverage
object
обязательно

Что банк передал из истории, которую вы запросили.

Последнее изменение 22 ноября 2026 г.