---
title: "Получить карточку подключения к банку"
method: GET
path: "/api/v1/finance/connectors/{id}"
tags: ["Finance connectors"]
---

# Получить карточку подключения к банку

`GET /api/v1/finance/connectors/{id}`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/finance/connectors/{id}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)
  - HTTP bearer

Возвращает карточку указанного банковского подключения.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Tenant` string, required

## Response `200`

Карточка подключения без сохранённых секретов

- FinanceConnector
  - `id` string, uuid, required
  - `provider` 'modulbank' | 'tbank' | 'tochka' | 'alfa' | 'sber', required
  - `provider_name` string, required
  - `display_name` string, required
  - `company_name` string, required
  - `company` string, uuid, nullable, required
  - `company_directory_name` string, required
  - `company_inn` string, required
  - `status` 'connected' | 'paused' | 'error' | 'reauth_required' | 'awaiting_consent' | 'disconnected', required
  - `status_name` string, required
  - `auth_kind` 'token' | 'client_credentials' | 'oauth' | 'oauth_mtls', required
  - `has_credentials` boolean, required: Только признак; сохранённый секрет никогда не возвращается
  - `mtls_certificate` FinanceConnectorMTLSStatus, required
    - `configured` boolean, required
    - `expires_at` string, date-time, nullable
    - `warning` string
  - `external_customer_id` string, required
  - `granted_by_user_id` integer, nullable, required
  - `granted_by_name` string, required
  - `granted_at` string, date-time, nullable, required
  - `import_depth_days` integer, required
  - `overlap_days` integer, required
  - `last_sync_at` string, date-time, nullable, required
  - `last_sync_status` string, required
  - `last_error` string, required: The provider's technical reply, verbatim — material for an investigation, not a message for the cabinet screen: it may carry machine keys such as "invalid_client". The portal operator reads it in full on the bank connectors page, while the cabinet card renders last_error_code instead. Empty when the failure was ours: an internal cause never reaches this field, it is logged and named by last_error_code instead.
  - `last_error_code` '' | 'finance.connector.internal' | 'finance.connector.provider_unauthorized' | 'finance.connector.provider_rate_limited' | 'finance.connector.provider_declined' | 'finance.connector.consent_required', required: Machine code of the last failure, translated by the client. Present because the text is stored: it is written in whatever locale the background sync happened to run in, and only a finite code can be rendered in the reader's language.
  - `accounts_total` integer, required
  - `accounts_linked` integer, required
  - `can_delete` boolean, required: True only for an abandoned connection attempt: no accounts returned by the bank and no sync run at all. Everything else is the origin trail of the imported operations and is never deleted — both links cascade — so such a connection is disconnected instead.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)