Посібник Документація API

Документація API

Fintable підключається до ваших банків і синхронізує рахунки, баланси, транзакції та інвестиційні активи з таблицями на кшталт Google Sheets чи Airtable. Fintable API V2 відкриває ці самі дані (і не тільки!) для вашого власного коду: усе, що зберігається у Fintable — банківські підключення, рахунки, транзакції, інвестиційні активи, категоризатор і ваші інтеграції з таблицями — доступне через зрозумілий REST-інтерфейс.

Проте Fintable API — це не лише про ваші приватні фінансові дані. Це також публічний API публічної фінансової інформації, як-от курси валют і ціни акцій. Fintable API задуманий як єдине джерело всього необхідного, щоб побудувати з нуля власний фінансовий застосунок (для себе, а не на перепродаж).

API приватних даних

Використовується, щоб отримувати ваші приватні фінансові дані — як-от баланси банківських рахунків і транзакції.

API публічних даних

Містить публічні фінансові дані, дуже корисні для створення повноцінних фінансових застосунків і дашбордів, — як-от актуальні курси валют і ціни акцій.

API панелі / керування

Використовується, щоб керувати самим Fintable, створювати нові банківські підключення та перевіряти стан їхньої синхронізації — так що вам навіть не доведеться заходити в панель Fintable.

Жодного доступу третіх сторін для платформ чи застосунків — лише ваші дані

Fintable API призначений строго для власних даних — для банківських рахунків, якими ви володієте або які маєте право контролювати безпосередньо (наприклад, рахунки ваших клієнтів, якщо ви бухгалтер). Це не платформа агрегації даних на кшталт Plaid — його не можна й не слід використовувати для створення фінансових застосунків на перепродаж, лише для себе.

Початок роботи

Ніколи раніше не користувалися Fintable? Ось увесь шлях — від нуля до першого виклику API над власними банківськими даними.


Базова URL-адреса	`https://fintable.io/api/v2`
Опис OpenAPI 3.1	`https://fintable.io/api/v2/openapi.json`
MCP-сервер для AI-асистентів	`https://fintable.io/mcp`
AI-скіл або документація для LLM (llms.txt)	`https://fintable.io/llms.txt`
Керування токенами	Панель → API

1. Створіть акаунт Fintable

Зареєструйтеся тут — почати можна безкоштовно, і безкоштовний тариф включає доступ до API, тож ви можете розробляти на його основі ще до того, як за щось платити.

2. Створіть персональний токен доступу

Відкрийте Панель → API і створіть персональний токен доступу, обравши доступ лише для читання або читання й запис. Токен показується лише один раз, тож скопіюйте його в безпечне місце й ставтеся до нього як до пароля. Саме його ваші скрипти надсилатимуть, щоб автентифікуватися від вашого імені.

3. Підключіть банківський рахунок

Створіть посилання, відкрийте отриману URL-адресу й пройдіть кроки у браузері, щоб завершити підключення банку:

curl -X POST https://fintable.io/api/v2/connections/link \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

{
    "data": {
        "url": "https://fintable.io/api-link/eyJpdiI6...",
        "expires_at": "2026-07-26T15:42:00Z"
    }
}

Одноразове посилання діє 30 хвилин; щойно ви його пройдете, Fintable почне синхронізувати рахунки й транзакції банку. Усі подробиці (попередній вибір установи, перепідключення, право на підключення) — у розділі POST /connections/link.

4. Отримайте свої баланси та транзакції

Щойно завершиться перша синхронізація — зазвичай за кілька хвилин — ваші дані вже на місці. Баланси:

curl https://fintable.io/api/v2/accounts \
  -H "Authorization: Bearer YOUR_TOKEN"

{
    "data": [
        {
            "id": "acc_01J9V5R9WQD3M8Y2KXN4T7PB6C",
            "name": "Chase Total Checking",
            "balance": "5240.12",
            "balance_available": "5190.12",
            "currency": "USD",
            "...": "..."
        }
    ]
}

І транзакції:

curl "https://fintable.io/api/v2/transactions?limit=5" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
    "data": [
        {
            "id": "tx_01JB2M9QK4R7X3W8N5PDY6TF2H",
            "date": "2026-07-24",
            "amount": "-4.50",
            "currency": "USD",
            "description": "BLUE BOTTLE COFFEE",
            "...": "..."
        }
    ],
    "next_cursor": null
}

Повні структури, фільтри й пагінація описані в розділах Рахунок і Транзакція — і весь Довідник API побудований за тим самим принципом. Віддаєте перевагу згенерованим клієнтам? Спрямуйте Swagger UI, Postman чи свій генератор коду на опис OpenAPI 3.1: https://fintable.io/api/v2/openapi.json.

Автентифікація

Є два способи входу — залежно від того, що саме ви створюєте:

Персональні токени доступу — для власних скриптів та інструментів. Створіть токен у панелі, додайте його в заголовок — і готово.
OAuth 2.0 — для застосунків і AI-асистентів, які підключаються до вашого акаунта через повноцінний потік авторизації (саме це використовує MCP-сервер під капотом).

Персональні токени доступу

Створюйте та відкликайте токени на сторінці Панель → API. Токени діють 1 рік і мають ті області, які ви обираєте під час створення, — лише читання (read) або читання й запис (read + write). Надсилайте їх як bearer-заголовок:

Authorization: Bearer YOUR_TOKEN

Відкликання набуває чинності негайно.

OAuth 2.0

Fintable працює як стандартний сервер авторизації OAuth 2.0, тож підійде будь-яка готова клієнтська бібліотека OAuth:

Endpoint	URL
Авторизація	`https://fintable.io/oauth/authorize`
Токен	`https://fintable.io/oauth/token`
Динамічна реєстрація клієнтів	`https://fintable.io/oauth/register`
Виявлення (discovery)	`https://fintable.io/.well-known/oauth-authorization-server`

Кілька деталей, які варто знати:

Підтримуваний grant — Authorization Code + PKCE.
Токени доступу діють 1 годину; токени оновлення — 30 днів.
Авторизація завжди вимагає входу та повторного підтвердження пароля акаунта. На екрані згоди чітко вказано, що саме зможе робити застосунок. Ця перешкода навмисна — це ваші банківські дані.

Області доступу

Область	Що дозволяє
`read`	Читати всі дані акаунта
`write`	Змінювати дані — перейменовувати, категоризувати, вмикати/вимикати, видаляти, синхронізувати
`mcp:use`	Повний доступ на читання та запис для MCP-клієнтів (Claude, ChatGPT, Codex)

mcp:use є надмножиною: він приймається всюди, де приймаються read або write. Звичайні токени read/write MCP-ендпоїнт відхиляє.

Воркспейси (Workspaces)

Воркспейс — це ізольований набір підключень, рахунків, транзакцій, правил категоризатора та інтеграцій Fintable. Кожен акаунт має воркспейс за замовчуванням — власний воркспейс власника облікових даних, який використовується, коли воркспейс не вибрано. На тарифах Office та Enterprise можна додавати керовані воркспейси для клієнтів, компаній чи родин під основним воркспейсом, якому належить оплата. Воркспейси — це спосіб безпечно ділитися фінансовими даними з командою, родичем чи клієнтом: кожен воркспейс має власний вхід і власний явно наданий доступ до API, обмежений лише цим воркспейсом.

Скоупи та доступи до воркспейсів відповідають на різні запитання: скоупи — це що можуть робити облікові дані (читати/писати), а доступи до воркспейсів — де вони можуть це робити. Вони поєднуються: токен лише для читання з трьома наданими воркспейсами може читати всі три й не може писати в жоден.

Надання доступу до воркспейсів

Доступ до керованого воркспейса надається явно, для кожних облікових даних окремо:

Персональні токени доступу — позначте воркспейси, доступні токену, під час його створення на сторінці Панель → API, або змініть доступ наявного токена пізніше (без ротації секрету).
Застосунки OAuth / MCP — екран згоди показує ваші доступні воркспейси; позначте ті, до яких застосунок матиме доступ. Доступ прив'язаний до застосунку, тож переживає оновлення токенів. Змінити чи відкликати його можна будь-коли в розділі Підключені застосунки.

Ніщо не надається мовчки: наявні облікові дані залишаються обмеженими воркспейсом за замовчуванням, доки ви не зміните їхній доступ або не підключите їх повторно, а новостворені воркспейси ніколи не додаються до наявних облікових даних автоматично. Доступи перевіряються на кожному запиті: відкликання, пониження тарифу чи видалення воркспейса діють негайно.

GET /workspaces

Повертає воркспейси, які можуть вибирати ці облікові дані: спочатку воркспейс за замовчуванням, далі надані керовані воркспейси за назвою. Сам цей ендпоінт не приймає workspace_id.

curl https://fintable.io/api/v2/workspaces \
  -H "Authorization: Bearer YOUR_TOKEN"

{
    "data": [
        {
            "id": "ws_01K2F3A6QH2D5J7M9V4X8N1BRC",
            "name": "Nate",
            "kind": "primary",
            "is_default": true
        },
        {
            "id": "ws_01K2F3C41W8B6Z0H7R9T5Y2QPM",
            "name": "Client A",
            "kind": "managed",
            "is_default": false
        }
    ]
}

Поле	Тип	Значення
`id`	string	Непрозорий публічний ID воркспейса — значення, яке передається як `workspace_id`
`name`	string	Видима назва воркспейса
`kind`	string	Тарифні відносини: `primary` володіє тарифом; `managed` покривається тарифом свого основного
`is_default`	boolean	`true` для воркспейса, який використовується, коли `workspace_id` не вказано

Вибір воркспейса

Кожен прив'язаний до воркспейсів ендпоінт приймає необов'язковий параметр запиту workspace_id — для всіх HTTP-методів. Це завжди параметр запиту: тіла запитів містять лише дані ресурсу, і поле workspace_id у JSON-тілі ніколи не вибирає воркспейс.

# Прочитати транзакції клієнта
curl "https://fintable.io/api/v2/transactions?workspace_id=ws_01K2F3C41W8B6Z0H7R9T5Y2QPM&limit=100" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Перейменувати рахунок у цьому воркспейсі (селектор у запиті, тіло — дані ресурсу)
curl -X PATCH "https://fintable.io/api/v2/accounts/1234?workspace_id=ws_01K2F3C41W8B6Z0H7R9T5Y2QPM" \
  -H "Authorization: Bearer YOUR_TOKEN" -H "Content-Type: application/json" \
  -d '{"display_name": "Client A Checking"}'

# Запустити там синхронізацію
curl -X POST "https://fintable.io/api/v2/sync?workspace_id=ws_01K2F3C41W8B6Z0H7R9T5Y2QPM" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Створити посилання підключення, що додасть банк у цей воркспейс
curl -X POST "https://fintable.io/api/v2/connections/link?workspace_id=ws_01K2F3C41W8B6Z0H7R9T5Y2QPM" \
  -H "Authorization: Bearer YOUR_TOKEN"

Селектор застосовується до /connections, /accounts, /transactions, /sync, /integrations та всіх ендпоінтів /categorizer/*, включно з їхніми маршрутами елементів і посилань. Він не застосовується до:

/me — завжди описує автентифікованого власника облікових даних та його тарифний стан; workspace_id ніколи його не змінює
/workspaces — визначає допустимі значення селектора
публічних ендпоінтів (/guide, /docs, /openapi.json, /institutions, /rates, /prices)
/feedback — звертається до підтримки, а не до даних воркспейса

Деталі поведінки:

Якщо workspace_id не вказано, поведінка залишається точно такою, як сьогодні: облікові дані працюють зі своїм воркспейсом за замовчуванням. Передати ID власного воркспейса — те саме, що не передати нічого.
Успішні відповіді прив'язаних ендпоінтів додають workspace_id верхнього рівня поряд із data/next_cursor: {"data": [...], "workspace_id": "ws_...", "next_cursor": null}.
Невідомий, некоректний, видалений або ненаданий workspace_id повертає стандартний конверт помилки not_found: невідоме й неавторизоване навмисно нерозрізненні.
Курсори пагінації транзакцій прив'язані до воркспейса, для якого їх видано; повторне використання курсора з іншим воркспейсом завершується помилкою invalid_cursor. Запитуйте кожну сторінку з тим самим workspace_id.
Ліміти частоти належать обліковим даним/власнику, а не вибраному воркспейсу: вибір кількох воркспейсів ніколи не множить квоту.
Посилання підключення, створені з workspace_id, створюють або повторно підключають банки в цьому воркспейсі. Браузерний флоу запитує ваш пароль (власника облікових даних), а далі продовжує в цільовому воркспейсі.

Довідник API

Усе, що описано нижче, використовує ту саму bearer-автентифікацію, а спільні поведінки — конверти, суми у вигляді рядків, помилки, ліміти частоти, пагінація — описані в розділах Домовленості API і Пагінація нижче. Кожен розділ описує один тип ресурсу: що це, його точна структура (реалістичний приклад і пояснення кожного поля), а далі — ендпоїнти, які з ним працюють.

Профіль

Endpoint	Що робить
`GET /me`	Ваш профіль і платіжні метадані

Профіль — це ваш акаунт з погляду API: хто ви, на якому плані та скільки запасу вам лишилося. Перевіряйте його перед додаванням підключення чи запуском синхронізації — саме ці ліміти застосовують ендпоїнти запису.

{
    "data": {
        "name": "Jamie",
        "tier": "personal",
        "plan_period": "monthly",
        "connection_limit": 10,
        "connections_used": 3,
        "tx_365_limit_usd": null,
        "can_sync": true,
        "renews_at": "2026-08-14T00:00:00Z",
        "renewal_amount": "9.00",
        "renewal_currency": "USD",
        "will_renew": true,
        "expires_at": "2026-08-14T00:00:00Z"
    }
}

Поле	Тип	Значення
`name`	string	Ваше видиме ім'я
`tier`	string	Рівень плану: `free`, `trial`, `personal`, `office` або `enterprise`
`plan_period`	string \| null	Періодичність оплати: `monthly`, `annual`, `lifetime`, `trial` або `manual`; `null` на безкоштовних акаунтах
`connection_limit`	integer	Максимальна кількість банківських підключень, дозволена вашим планом. Додати підключення не вдасться, якщо `connections_used` уже досяг цього числа. Безкоштовні акаунти повідомляють поточну кількість як ліміт (вільних місць немає).
`connections_used`	integer	Скільки банківських підключень у вас зараз. Порівняйте з `connection_limit`, щоб дізнатися залишок: `connection_limit - connections_used`. Відключення банку зменшує це число; сам ліміт не змінюється, поки не зміниться план.
`tx_365_limit_usd`	integer \| null	Рухомий ліміт обсягу транзакцій за 365 днів у USD; обсяг дорівнює `max(abs(усі надходження), abs(усі витрати))` для всіх увімкнених банківських рахунків і субакаунтів; `null` означає без обмежень
`can_sync`	boolean	Чи доступні синхронізації (`false` на безкоштовних акаунтах)
`renews_at`	string \| null	Час ISO-8601, коли поновлюється активна підписка
`renewal_amount`	string \| null	Ціна поновлення у вигляді десяткового рядка
`renewal_currency`	string \| null	Код валюти поновлення
`will_renew`	boolean	Чи поновиться підписка автоматично
`expires_at`	string \| null	Коли завершується поточне право користування

Безкоштовні акаунти отримують "tier": "free", "can_sync": false і поточну кількість підключень як ліміт.

GET /me

Повертає ваш Профіль — об'єкт вище. Без параметрів:

curl https://fintable.io/api/v2/me \
  -H "Authorization: Bearer YOUR_TOKEN"

Підключення

Endpoint	Що робить
`GET /connections`	Список усіх підключень
`GET /connections/{id}`	Одне підключення
`PATCH /connections/{id}`	Перейменувати або задати дату початку синхронізації
`DELETE /connections/{id}`	Відключити банк і видалити його дані
`POST /connections/link`	Створити браузерне посилання для підключення нового банку
`POST /connections/{id}/link`	Створити браузерне посилання для перепідключення цього банку

Підключення — це один прив'язаний банк, тобто один вхід в одну установу. Підключення володіє одним або кількома рахунками й містить стан справності та синхронізації цих банківських відносин.

{
    "data": {
        "id": "conn_plaid_1771845993762884095",
        "provider": "PLAID",
        "institution_name": "Chase",
        "name": null,
        "healthy": true,
        "status_text": "OK",
        "needs_reconnect": false,
        "last_successful_update": "2026-07-26T09:12:44Z",
        "created_at": "2025-11-02T18:20:11Z",
        "accounts_count": 3,
        "sync_status": {
            "state": "finished",
            "progress_now": 4,
            "progress_max": 4,
            "stage": "Sync complete",
            "started_at": "2026-07-26T09:11:58Z",
            "finished_at": "2026-07-26T09:12:44Z"
        }
    }
}

Поле	Тип	Значення
`id`	string	Ідентифікатор підключення, `conn_{provider}_{number}`
`provider`	string	Провайдер цього підключення, напр. `PLAID`, `NORDIGEN`, `AKOYA`, `FINICITY`, `MERCURY`, `PRIVATBANK-BIZ`, `MONOBANK`, `SNAPTRADE`
`institution_name`	string	Назва банку (ваша власна назва, якщо задана)
`name`	string \| null	Ваша власна назва підключення
`healthy`	boolean	`false`, коли провайдер повідомляє про проблему або остання синхронізація завершилася помилкою
`status_text`	string	Зрозумілий статус: `OK`, `Last sync failed.` або повідомлення про помилку від провайдера
`needs_reconnect`	boolean	`true`, коли банк вимагає повторної автентифікації
`last_successful_update`	string \| null	Час ISO-8601 останньої успішної синхронізації
`created_at`	string	Коли банк було підключено
`accounts_count`	integer	Кількість рахунків у цьому підключенні
`sync_status`	object \| null	Найновіше завдання синхронізації — об'єкт Стан синхронізації

GET /connections

Повертає список усіх ваших підключень. Без параметрів.

GET /connections/{id}

Одне підключення за ідентифікатором.

PATCH /connections/{id}

Перейменовує підключення або задає дату початку синхронізації. Приймає одне або обидва поля:

name — ваша власна назва, максимум 64 символи; null очищає її.
sync_start_date — YYYY-MM-DD; null очищає її. Fintable синхронізуватиме транзакції лише починаючи з цієї дати.

curl -X PATCH https://fintable.io/api/v2/connections/conn_plaid_1771845993762884095 \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Chase (Jamie)", "sync_start_date": "2026-01-01"}'

Відповідь — оновлений об'єкт підключення. Дві деталі: дата початку застосовується лише до увімкнених рахунків підключення (вимкнені зберігають свою дату до повторного ввімкнення), і дата перевіряється щодо мінімальної глибини історії провайдера та 30-денного ліміту пробних акаунтів (422, якщо поза діапазоном).

DELETE /connections/{id}

Відключає банк і видаляє його рахунки та транзакції з Fintable. Оскільки видалення залучає провайдера, воно завершується асинхронно — відповідь має код 202:

{
    "data": {
        "id": "conn_plaid_1771845993762884095",
        "status": "deleting"
    }
}

Підключення та його дані зникають протягом кількох хвилин.

POST /connections/link

Підключити банк означає увійти в нього, а сторінки входу в банк потребують справжнього браузера — тож це єдиний потік, який API не може завершити самостійно. Натомість цей ендпоїнт створює одноразову URL-адресу, дійсну 30 хвилин, яку ви відкриваєте самі (або передаєте власнику акаунта — це ж його акаунт):

curl -X POST https://fintable.io/api/v2/connections/link \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"institution": "12913262_chase"}'

{
    "data": {
        "url": "https://fintable.io/api-link/eyJpdiI6...",
        "expires_at": "2026-07-26T15:42:00Z"
    }
}

Поле institution необов'язкове — це slug із каталогу Установ, який попередньо вибирає банк у потоці. Той, хто відкриє URL-адресу, побачить, до якого акаунта Fintable виконується підключення, підтвердить пароль акаунта й потрапить у потік вибору банку від провайдера. Посилання згоряє після першого успішного підтвердження.

Створення посилання вимагає активного плану із запасом: активної підписки або пробного періоду, у межах ліміту підключень, у межах місячного ліміту спроб і в межах ліміту обсягу транзакцій — інакше 422 з поясненням (і ті самі перевірки виконуються повторно, коли банк справді створюється).

POST /connections/{id}/link

Працює так само, як POST /connections/link, але створює посилання для перепідключення наявного підключення й звільнений від перевірок для нових підключень.

Рахунок

Endpoint	Що робить
`GET /accounts`	Список усіх рахунків, зокрема вимкнених
`GET /accounts/{id}`	Один рахунок
`PATCH /accounts/{id}`	Оновити `display_name`, `sync_start_date` та/або `enabled`

Рахунок — це окремий банківський рахунок усередині підключення: поточний рахунок, ощадний рахунок, брокерський рахунок. Саме на рахунках зберігаються баланси, і саме їм належать транзакції.

{
    "data": {
        "id": "acc_01J9V5R9WQD3M8Y2KXN4T7PB6C",
        "ext_id": "Qg39dj7M9vIqwQrybDRni1oMKAAvx8s4vO4yO",
        "connection_id": "conn_plaid_1771845993762884095",
        "name": "Chase Total Checking",
        "display_name": "Household checking",
        "type": "depository / checking",
        "currency": "USD",
        "balance": "5240.12",
        "balance_available": "5190.12",
        "sync_start_date": "2026-01-01",
        "last_tx_date": "2026-07-25",
        "enabled": true,
        "created_at": "2025-11-02T18:20:14Z",
        "updated_at": "2026-07-26T09:12:40Z"
    }
}

Поле	Тип	Значення
`id`	string	Ідентифікатор рахунку — непрозорий, зазвичай `acc_...`
`ext_id`	string	Власний ідентифікатор провайдера — колонка `**Plaid Account ID` у ваших таблицях. Див. зіставлення з рядками таблиці
`connection_id`	string	Підключення, якому належить цей рахунок
`name`	string	Назва рахунку в банку
`display_name`	string \| null	Ваша власна назва — саме вона відображається у ваших таблицях
`type`	string	Вільний текст у стилі провайдера, як-от `depository / checking` чи `investment / brokerage` — показуйте його, але не будуйте на ньому логіку
`currency`	string	Діючий код валюти (враховує будь-яке задане вами перевизначення)
`balance`	string \| null	Поточний баланс у вигляді десяткового рядка
`balance_available`	string \| null	Доступний баланс, якщо банк його повідомляє
`sync_start_date`	string \| null	`YYYY-MM-DD` — транзакції синхронізуються лише починаючи з цієї дати
`last_tx_date`	string \| null	Дата найновішої синхронізованої транзакції
`enabled`	boolean	Чи синхронізується рахунок; вимкнені рахунки й далі показуються тут зі `enabled: false`
`created_at` / `updated_at`	string	Мітки часу ISO-8601

GET /accounts

Повертає всі рахунки, зокрема вимкнені (enabled: false). Фільтри: connection_id, ids[] та enabled.

GET /accounts/{id}

Один рахунок за ідентифікатором.

PATCH /accounts/{id}

Оновлює display_name, sync_start_date та/або enabled.

Увага: вимкнення рахунку видаляє його транзакції. Встановлення "enabled": false назавжди видаляє всі транзакції цього рахунку у Fintable — так само, як перемикач у панелі. Повторне ввімкнення їх не відновлює; наступна синхронізація має завантажити їх від провайдера заново. Не вимикайте рахунок, якщо це не саме те, чого ви хочете.

Актив

Endpoint	Що робить
`GET /accounts/{id}/holdings`	Один зріз активів рахунку

Актив — це одна позиція на інвестиційному рахунку: акція, фонд або інший цінний папір. Fintable зберігає активи як щоденні зрізи: що ви тримали й за якою ціною, раз на день. Відповідь із активами — це набір рядків за одну дату зрізу, а сама дата подається в конверті як snapshot_date.

{
    "data": [
        {
            "id": "hol_01JB7Q2M5X8R4T6W9NKZP3VD1F",
            "name": "Vanguard Total Stock Market ETF",
            "symbol": "VTI",
            "quantity": "42.0000",
            "price": "279.35",
            "value": "11732.70",
            "cost_basis": "9450.00",
            "currency": "USD",
            "updated_at": "2026-07-26T09:12:41Z"
        }
    ],
    "snapshot_date": "2026-07-26"
}

Поле	Тип	Значення
`id`	string	Ідентифікатор активу — непрозорий, зазвичай `hol_...`
`name`	string	Назва цінного папера
`symbol`	string \| null	Тікер, якщо провайдер його повідомляє
`quantity`	string \| null	Кількість одиниць у вигляді десяткового рядка
`price`	string \| null	Ціна за одиницю
`value`	string \| null	Поточна ринкова вартість позиції
`cost_basis`	string \| null	Загальна вартість позиції, а не за одну акцію — особливість провайдера, яку ми передаємо як є, а не намагаємося вгадати
`currency`	string	Діюча валюта рахунку
`updated_at`	string \| null	Коли цей рядок було записано востаннє
`snapshot_date` (конверт)	string \| null	День зрізу, який описує ця відповідь; `null`, коли на рахунку немає активів

GET /accounts/{id}/holdings

За замовчуванням повертає найновіший зріз; ?date=YYYY-MM-DD вибирає конкретний. Пагінації історії немає — завантажуйте дату за датою.

Транзакція

Endpoint	Що робить
`GET /transactions`	Усі транзакції, з курсорною пагінацією
`GET /accounts/{id}/transactions`	Транзакції одного рахунку
`GET /transactions/{id}`	Одна транзакція
`PATCH /transactions/{id}`	Задати або очистити категорію
`PATCH /transactions/bulk`	Категоризувати багато транзакцій одразу

Серце API. Транзакція — це один рух коштів на рахунку: покупка, надходження, переказ, комісія. Транзакції несуть стан категоризації — і призначену категорію, і те, чи була вона задана вручну, чи правилом.

{
    "data": {
        "id": "tx_01JB2M9QK4R7X3W8N5PDY6TF2H",
        "ext_id": "3k3OMr7qdPtD8oXPPBNZtarZeDDPwwfoPX0ED",
        "account_id": "acc_01J9V5R9WQD3M8Y2KXN4T7PB6C",
        "date": "2026-07-24",
        "datetime": "2026-07-24T16:41:02Z",
        "auth_date": "2026-07-23",
        "amount": "-4.50",
        "currency": "USD",
        "description": "BLUE BOTTLE COFFEE",
        "merchant": "Blue Bottle Coffee",
        "pending": false,
        "check_num": null,
        "external_memo": null,
        "account_owner": null,
        "category": {
            "id": "dining-out_aB3xY9k2Lm",
            "name": "Dining Out",
            "header": "Expenses"
        },
        "category_manual_override": false,
        "created_at": "2026-07-24T18:03:12Z",
        "updated_at": "2026-07-25T06:14:09Z"
    }
}

Поле	Тип	Значення
`id`	string	Ідентифікатор транзакції — непрозорий, зазвичай `tx_...`
`ext_id`	string	Власний ідентифікатор провайдера — колонка `**Plaid TX ID` у ваших таблицях. Див. зіставлення з рядками таблиці
`account_id`	string	Рахунок, якому належить ця транзакція — його `id`, а не колонка `**Plaid Account ID` (деталі)
`date`	string	Дата транзакції, `YYYY-MM-DD`
`datetime`	string \| null	Точний час ISO-8601, якщо провайдер його надає
`auth_date`	string \| null	Дата авторизації, коли вона відрізняється від дати проведення
`amount`	string	Точний десятковий рядок; від'ємне значення — кошти на вихід
`currency`	string	Діючий код валюти
`description`	string	Опис із виписки
`merchant`	string \| null	Очищена назва продавця, якщо відома
`pending`	boolean	`true`, поки транзакція не проведена — очікувані рядки можуть бути замінені після проведення
`check_num`	string \| null	Номер чека для чекових платежів
`external_memo`	string \| null	Додатковий текст примітки від банку
`account_owner`	string \| null	Ім'я власника на спільних рахунках або рахунках із кількома власниками
`category`	object \| null	Призначена Категорія — `{id, name, header}` — або `null`, якщо категорії немає
`category_manual_override`	boolean	`true`, коли категорію задано вручну; правила ніколи не чіпають такі рядки
`created_at` / `updated_at`	string	Мітки часу ISO-8601; `updated_at` є основою інкрементної синхронізації
`raw`	object	Сирий JSON провайдера — присутній лише з `?include=raw`; ті самі дані, що й у полях `**Raw` ваших таблиць

GET /transactions

Усі ваші транзакції, з курсорною пагінацією, за замовчуванням від найновіших. Фільтри:

Фільтр	Значення
`date_from`, `date_to`	Діапазон дат (`YYYY-MM-DD`, включно)
`account_ids[]`	Обмежити конкретними рахунками
`category_ids[]`	Обмежити категоріями — вкажіть літерал `uncategorized` для рядків без категорії
`pending`	`true` або `false`
`amount_min`, `amount_max`	Діапазон сум
`q`	Пошук підрядка без урахування регістру за описом і продавцем
`description`	Точний збіг опису
`updated_since`, `order`	Для інкрементної синхронізації; `order` — це `date` або `updated`

GET /accounts/{id}/transactions

Транзакції одного рахунку — ті самі фільтри, пагінація та структура, що й у GET /transactions.

GET /transactions/{id}

Одна транзакція за ідентифікатором. ?include=raw працює й тут.

PATCH /transactions/{id}

Робить рівно одну річ — задає категорію:

curl -X PATCH https://fintable.io/api/v2/transactions/tx_01JB2M9QK4R7X3W8N5PDY6TF2H \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"category_id": "dining-out_aB3xY9k2Lm"}'

Задання категорії позначає транзакцію як змінену вручну (category_manual_override: true) — правила більше ніколи її не торкнуться. Значення "category_id": null знімає категорію і скасовує позначку ручної зміни, тож правила можуть застосуватися знову під час наступного проходу. Відповідь — оновлена транзакція.

PATCH /transactions/bulk

Застосовує один category_id (або null) до багатьох транзакцій одразу. Виберіть цілі рівно одним із двох селекторів:

ids[] — до 10 000 ідентифікаторів (чужі ідентифікатори тихо пропускаються), або
filters — ті самі ключі, що й в ендпоїнті списку. Щоб через одну одруківку не перекатегоризувати всю вашу історію, фільтр має містити принаймні один звужувальний ключ — date_from, date_to, account_ids, category_ids, q або description (pending і amount_* можуть уточнювати, але самі по собі не рахуються). Якщо під фільтр підпадає понад 10 000 транзакцій, запит завершується помилкою 422 — звузьте та повторіть.

Не впевнені, що зачепить фільтр? Спершу виконайте пробний запуск:

curl -X PATCH https://fintable.io/api/v2/transactions/bulk \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {"q": "whole foods", "date_from": "2026-01-01"},
    "category_id": "groceries_x7Pq2Rv9Zn",
    "dry_run": true
  }'

{
    "data": {
        "dry_run": true,
        "matched_count": 37,
        "sample": [
            "... up to 10 matching transactions ..."
        ]
    }
}

Результат влаштовує? Надішліть той самий запит без dry_run:

{
    "data": {
        "dry_run": false,
        "updated_count": 37
    }
}

Виконання оновлює всі знайдені рядки й синхронізує категорії з вашими таблицями один раз, як єдиний експорт.

Синхронізація

Endpoint	Що робить
`GET /sync`	Розклад, поточні синхронізації та статус кожного підключення
`POST /sync`	Синхронізувати всі підключення зараз
`POST /sync/{connection_id}`	Синхронізувати одне підключення зараз

Синхронізація — це один запуск завантаження свіжих даних із банківського підключення до Fintable. Fintable планує їх автоматично: кожен рахунок бере участь у рандомізованому проході, який виконується кожні 6–23 години, тож точного «часу наступної синхронізації» навмисно не існує. API дозволяє переглянути розклад, спостерігати за поточними синхронізаціями та (на платних планах) запустити синхронізацію на вимогу.

Повторюваною структурою тут є об'єкт Стан синхронізації — він з'являється в кожному Підключенні і по всьому GET /sync:

{
    "state": "finished",
    "progress_now": 4,
    "progress_max": 4,
    "stage": "Sync complete",
    "started_at": "2026-07-26T09:11:58Z",
    "finished_at": "2026-07-26T09:12:44Z"
}

Поле	Тип	Значення
`state`	string	`queued`, `executing`, `finished`, `failed` або `retrying`
`progress_now`	integer \| null	Скільки кроків виконано
`progress_max`	integer \| null	Загальна кількість кроків у цьому запуску
`stage`	string \| null	Зрозумілий опис поточного етапу
`started_at`	string \| null	Коли запуск почався
`finished_at`	string \| null	Коли запуск завершився; `null`, поки він триває

GET /sync

Обгортає об'єкти Стану синхронізації в повну картину — ваш розклад плюс статус кожного підключення:

Поле	Тип	Значення
`schedule.type`	string	`default` (рандомізований прохід) або `custom` (є розклади для конкретних провайдерів)
`schedule.last_sync_at`	string \| null	Коли прохід востаннє запускав ваші синхронізації
`schedule.next_sync_window`	object \| null	Приблизне вікно `{earliest, latest}` наступного проходу — точного часу не існує
`schedule.custom_schedules`	array	Розклади для конкретних провайдерів: `{provider, cron, timezone, next_run_at}`
`schedule.default_sweep_applies`	boolean	Типовий прохід застосовується до всіх рахунків, незалежно від власних розкладів
`active_syncs`	array	Завдання, що виконуються (або зависли чи впали): `{connection_id, sync_status}`
`connections`	array	Найновіший `{connection_id, sync_status}` кожного підключення

curl https://fintable.io/api/v2/sync \
  -H "Authorization: Bearer YOUR_TOKEN"

{
    "data": {
        "schedule": {
            "type": "default",
            "last_sync_at": "2026-07-26T09:11:55Z",
            "next_sync_window": {
                "earliest": "2026-07-26T15:23:00Z",
                "latest": "2026-07-27T09:11:55Z"
            },
            "custom_schedules": [],
            "default_sweep_applies": true
        },
        "active_syncs": [],
        "connections": [
            {
                "connection_id": "conn_plaid_1771845993762884095",
                "sync_status": {
                    "state": "finished",
                    "progress_now": 4,
                    "progress_max": 4,
                    "stage": "Sync complete",
                    "started_at": "2026-07-26T09:11:58Z",
                    "finished_at": "2026-07-26T09:12:44Z"
                }
            }
        ]
    }
}

POST /sync

Це API-версія кнопки «Синхронізувати всі підключення» в панелі. Вона завантажує закешовані дані провайдера — це не оновлення з банку в реальному часі:

{
    "data": [
        {
            "connection_id": "conn_plaid_1771845993762884095",
            "status": "started"
        },
        {
            "connection_id": "conn_nordigen_1802214467911184310",
            "status": "already_syncing"
        }
    ]
}

Синхронізація, яка вже виконується, повідомляється як already_syncing, а не як помилка. Потрібна активна підписка або пробний період — безкоштовні акаунти отримують 403 ще до початку. Стежте за прогресом через GET /sync або за полем sync_status кожного підключення.

POST /sync/{connection_id}

Синхронізує лише одне підключення — та сама структура відповіді, що й у POST /sync (один елемент), і та сама вимога до плану.

Категорія

Endpoint	Що робить
`GET /categorizer/categories`	Список категорій
`GET /categorizer/categories/{id}`	Одна категорія
`POST /categorizer/categories`	Створити категорію (201)
`PATCH /categorizer/categories/{id}`	Перейменувати, змінити групу, змінити колір
`DELETE /categorizer/categories/{id}`	Видалити категорію

Категорія — це мітка для транзакцій, базовий елемент категоризатора, за допомогою якого транзакції отримують мітки: категорії — це самі мітки, а Правила застосовують їх автоматично в міру надходження транзакцій. Усе, що можна зробити в панелі категоризатора, можна зробити й тут. Ліміт: 1 000 категорій на акаунт.

{
    "data": {
        "id": "groceries_x7Pq2Rv9Zn",
        "name": "Groceries",
        "header": "Expenses",
        "color": "green",
        "created_at": "2026-07-26T14:02:33Z",
        "updated_at": "2026-07-26T14:02:33Z"
    }
}

Поле	Тип	Значення
`id`	string	Ідентифікатор категорії, `{name-slug}_{10 літер і цифр}` — не змінюється при перейменуванні
`name`	string	Мітка, що відображається на транзакціях і у ваших таблицях
`header`	string	Група, під якою показується категорія, як-от `Expenses` чи `Income`
`color`	string	Назва з палітри панелі: `red`, `orange`, `amber`, `yellow`, `lime`, `green`, `emerald`, `teal`, `cyan`, `sky`, `blue`, `indigo`, `violet`, `purple`, `fuchsia`, `pink`, `rose`
`created_at` / `updated_at`	string	Мітки часу ISO-8601

GET /categorizer/categories

Повертає список усіх ваших категорій.

GET /categorizer/categories/{id}

Одна категорія за ідентифікатором.

POST /categorizer/categories

Створює категорію (201) — name, header і необов'язковий color:

curl -X POST https://fintable.io/api/v2/categorizer/categories \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Groceries", "header": "Expenses", "color": "green"}'

Відповідь — створена категорія (як вище).

PATCH /categorizer/categories/{id}

Оновлює name, header та/або color. Перейменування автоматично поширюються на ваші Airtable і Google Sheets.

DELETE /categorizer/categories/{id}

Видалення захищене: якщо якесь правило досі посилається на категорію, запит завершується помилкою 409 зі списком ідентифікаторів проблемних правил — спершу оновіть або видаліть ці правила. В іншому разі всі транзакції в категорії залишаються без категорії, а сама категорія видаляється:

{
    "data": {
        "deleted": true,
        "uncategorized_count": 118
    }
}

Правило

Endpoint	Що робить
`GET /categorizer/rules`	Список правил — лише метадані, без `logic`
`GET /categorizer/rules/{id}`	Одне правило разом із повною `logic`
`POST /categorizer/rules`	Створити правило (202)
`PATCH /categorizer/rules/{id}`	Оновити `name`, `priority` та/або `logic`
`DELETE /categorizer/rules/{id}`	Видалити правило
`POST /categorizer/sync`	Поставити в чергу повний прохід правил + експорт у таблиці (202)
`GET /categorizer/status`	На якому етапі конвеєр

Правило категоризує транзакції автоматично в міру їх синхронізації — це друга половина категоризатора. Ліміт: 1 000 правил на акаунт.

{
    "data": {
        "id": "a25a374d-e4d7-4652-aca7-5dd3c3d02d15",
        "name": "Big grocery runs",
        "type": "advanced",
        "priority": 7,
        "category_ids": [
            "groceries_x7Pq2Rv9Zn"
        ],
        "logic": {
            "if": [
                "..."
            ]
        },
        "created_at": "2026-07-26T14:10:05Z",
        "updated_at": "2026-07-26T14:10:05Z"
    }
}

Поле	Тип	Значення
`id`	string	Ідентифікатор правила — UUID
`name`	string	Видима назва (для простих правил генерується автоматично)
`type`	string	`simple` (опис містить текст) або `advanced` (сирий JSONLogic)
`priority`	integer	Правила виконуються в порядку `(priority, id)`; коли збігається кілька, перемагає правило з вищим пріоритетом
`category_ids`	array of strings	Категорії, які можуть призначати гілки цього правила
`logic`	object	Повний JSONLogic — присутній у `GET /categorizer/rules/{id}` та у відповідях на створення/оновлення, у списку пропускається
`created_at` / `updated_at`	string	Мітки часу ISO-8601

Як поводяться правила — варто прочитати один раз:

Правила виконуються в порядку (priority, id). Коли кілька правил збігаються з однією транзакцією, перемагає правило з вищим пріоритетом (воно застосовується останнім). priority можна змінити через PATCH.
Транзакції, категоризовані вручну (category_manual_override: true), правила ніколи не чіпають.
Прохід правил зберігає старі категоризації. Він перезаписує лише ті транзакції, які підпадають під поточний набір правил — видалення чи зміна правила не знімає категорії з транзакцій, які раніше під нього підпадали. Це відповідає поведінці панелі й зроблено навмисно. Щоб справді все скинути, зніміть категорії масово й запустіть прохід заново.
Ваші правила — єдине, що категоризує. Під час синхронізації нічого не категоризується, і Fintable ніколи не бере категорію з власного збагачення даних про продавця в провайдера — тож це працює однаково для Plaid, GoCardless, Akoya та решти. Транзакція з category: null означає, що жодне правило під неї не підійшло; це повне пояснення. POST /categorizer/sync заново прожене ваші поточні правила по всій історії, але не вигадає категорію, якої ваші правила не призначають. Щоб побачити, наскільки далеко сягають ваші правила, викличте GET /categorizer/status?include=coverage.

GET /categorizer/rules

Повертає список усіх ваших правил — лише метадані (id, name, type, priority, category_ids[]), без logic.

GET /categorizer/rules/{id}

Одне правило за ідентифікатором, разом із повною logic.

POST /categorizer/rules

Є два види. Прості правила покривають типовий випадок — «якщо опис містить X, віднеси до Y» (без урахування регістру, 3–128 символів):

curl -X POST https://fintable.io/api/v2/categorizer/rules \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type": "simple", "text": "STARBUCKS", "category_id": "dining-out_aB3xY9k2Lm"}'

Складні правила — це сирий JSONLogic: довільні умови щодо суми, дат, рахунку, опису й навіть сирих полів провайдера (див. довідник JSONLogic нижче). Зверніть увагу: logic — це рядок, закодований у JSON, а не вкладений об'єкт:

curl -X POST https://fintable.io/api/v2/categorizer/rules \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "advanced",
    "name": "Big grocery runs",
    "logic": "{\"if\": [{\"and\": [{\"in\": [\"WHOLE FOODS\", {\"var\": \"transaction.description\"}]}, {\"<\": [{\"var\": \"transaction.amount\"}, -100]}]}, \"groceries_x7Pq2Rv9Zn\", null]}"
  }'

Створення або оновлення правила повертає 202 з об'єктом правила (як вище) плюс поле верхнього рівня "application": "queued". Цей код 202 повідомляє щось важливе: правило збережено, і в чергу поставлено повний упорядкований прохід усіх ваших правил по всіх ваших транзакціях разом із об'єднаним експортом у ваші таблиці. Опитуйте GET /categorizer/status, щоб побачити завершення. Багато швидких змін дають один прохід і один експорт, а не по одному на кожну зміну.

PATCH /categorizer/rules/{id}

Оновлює name, priority та/або logic. Зміни поведінки (логіки чи пріоритету) повертають 202 і ставлять у чергу прохід правил, так само як створення; просте перейменування повертає 200 із "application": "none".

DELETE /categorizer/rules/{id}

Видаляє правило. Транзакції, які воно раніше категоризувало, зберігають свої категорії (див. примітки щодо поведінки вище).

Написання складних правил у JSONLogic

logic має бути JSON-об'єктом, єдиний оператор верхнього рівня якого — if. Кожна гілка результату має бути літеральним рядком з ідентифікатором категорії або літеральним null — ніколи не обчислюваним виразом. Ваша логіка обчислюється щодо такого входу для кожної транзакції:

{
    "transaction": {
        "fin_id": "tx_01JB2M9QK4R7X3W8N5PDY6TF2H",
        "ext_id": "3k3OMr7qdPtD8oXPPBNZtarZeDDPwwfoPX0ED",
        "account_id": "acc_01J9V5R9WQD3M8Y2KXN4T7PB6C",
        "date": "2026-07-24",
        "auth_date": "2026-07-23",
        "amount": "-4.50",
        "currency": "USD",
        "description": "BLUE BOTTLE COFFEE",
        "payee": "Blue Bottle Coffee",
        "sub_account": null,
        "acc_name": "Chase Total Checking",
        "raw": {
            "provider fields": "..."
        }
    }
}

Дві зручності, які варто помітити: description уже переведено у верхній регістр (тож пошук підрядка фактично не залежить від регістру), а amount — звичний десятковий рядок. fin_id та ext_id — це id і ext_id транзакції з API.

Одне застереження, яке варто врахувати в дизайні правил: payee рівно настільки хороший, наскільки хороші дані від банку. Чимало підключень — особливо серед відкритого банкінгу — не надсилають назви продавця взагалі, і в таких рядках payee дорівнює null. Правило, яке має працювати всюди, слід будувати на description, а за потреби додаткових даних — сягати в raw по поля конкретного провайдера.

Розібраний приклад — «карткові транзакції понад 100 $ у Whole Foods належать до Groceries» (пам'ятайте: від'ємне = кошти на вихід, тож витрачено понад 100 $ означає < -100):

{
    "if": [
        {
            "and": [
                {
                    "in": [
                        "WHOLE FOODS",
                        {
                            "var": "transaction.description"
                        }
                    ]
                },
                {
                    "<": [
                        {
                            "var": "transaction.amount"
                        },
                        -100
                    ]
                }
            ]
        },
        "groceries_x7Pq2Rv9Zn",
        null
    ]
}

Дозволені оператори: var, missing, missing_some, if, ==, ===, !=, !==, !, !!, or, and, >, >=, <, <=, max, min, +, -, *, /, %, map, reduce, filter, all, none, some, merge, in, cat, substr. (log не дозволено.)

Ліміти на одне правило: 16 КБ, глибина вкладеності 20 і бюджет складності у 100 вузлів операторів — операції над масивами (map, filter, reduce, all, none, some) рахуються з коефіцієнтом 10× і не можуть вкладатися одна в одну. Є також сукупний бюджет для всіх ваших правил; якщо ви його вичерпали, спростіть або видаліть частину правил.

POST /categorizer/sync

Ставить у чергу повний прохід правил плюс експорт у таблиці (202, {"data": {"application": "queued"}}). Зміни правил ставлять проходи в чергу автоматично, тож це рідко потрібно — воно існує для випадку «просто перезапусти все зараз».

GET /categorizer/status

Чесна картина конвеєра:

curl https://fintable.io/api/v2/categorizer/status \
  -H "Authorization: Bearer YOUR_TOKEN"

{
    "data": {
        "requested_version": 12,
        "completed_version": 12,
        "active_version": null,
        "settled": true,
        "failed_at": null,
        "destinations": [
            {
                "destination": "airtable",
                "requested_version": 12,
                "completed_version": 12,
                "failed_at": null
            },
            {
                "destination": "gsheet:184",
                "requested_version": 12,
                "completed_version": 12,
                "failed_at": null
            }
        ]
    }
}

Кожна запитана зміна збільшує requested_version; проходи та експорти його наздоганяють. active_version — це прохід, який виконується просто зараз; null, коли нічого не виконується. settled: true означає, що все, про що ви просили, повністю завершилося — і в базі даних, і в кожному призначенні-таблиці. Щоб дочекатися, поки зміна правила набуде чинності, опитуйте статус, доки settled не стане true.

Додайте ?include=coverage, щоб побачити, яку частину вашої історії справді охоплюють правила:

{
    "data": {
        "settled": true,
        "coverage": {
            "total": 4527,
            "categorized": 2627,
            "uncategorized": 1900,
            "manual_override": 12
        },
        "...": "..."
    }
}

total — це всі транзакції, які розглядає категоризатор, categorized — ті, що мають категорію, а manual_override — ті, які ви задали вручну (правила їх ніколи не чіпають). Велике значення uncategorized — не помилка й не обмеження провайдера: це кількість транзакцій, під які поки не підходить жодне ваше правило (див. як поводяться правила). Показник опційний, бо його обчислення сканує весь ваш набір транзакцій — не запитуйте його всередині циклу опитування settled.

Інтеграція

Endpoint	Що робить
`GET /integrations`	Стан і справність ваших інтеграцій із таблицями

Інтеграція — це призначення, у яке Fintable синхронізує дані: ваша база Airtable або ваші таблиці Google Sheets. Це міст між цим API і світом таблиць: візьміть тут base_id чи spreadsheet_id, а далі працюйте безпосередньо з власними API Airtable чи Google над синхронізованими даними.

GET /integrations

curl https://fintable.io/api/v2/integrations \
  -H "Authorization: Bearer YOUR_TOKEN"

{
    "data": {
        "airtable": {
            "base_id": "appXk2fW9qLmN3vT8",
            "url": "https://airtable.com/appXk2fW9qLmN3vT8",
            "accounts_table_name": "Accounts",
            "transactions_table_name": "Transactions",
            "holdings_table_name": "Holdings",
            "transactions_enabled": true,
            "token_type": "OAUTH",
            "healthy": true,
            "error": null
        },
        "google_sheets": [
            {
                "spreadsheet_id": "1vQx8mP2kL9nR4tY7wZ3jB6cD5eF8gH0iJ2kL4mN6oP8",
                "url": "https://docs.google.com/spreadsheets/d/1vQx8mP2kL9nR4tY7wZ3jB6cD5eF8gH0iJ2kL4mN6oP8",
                "title": "Family finances",
                "tabs": {
                    "accounts": {
                        "sheet": "Accounts",
                        "range": "A1:Z"
                    },
                    "transactions": {
                        "sheet": "Transactions",
                        "range": "A1:Z"
                    },
                    "holdings": {
                        "sheet": null,
                        "range": null
                    }
                },
                "healthy": true,
                "error": null
            }
        ]
    }
}

Об'єкт airtable (null, якщо ви не підключали Airtable):

Поле	Тип	Значення
`base_id`	string	База Airtable, у яку синхронізує Fintable — використовуйте її з власним API Airtable
`url`	string	Пряме посилання на базу
`accounts_table_name`	string	Налаштована таблиця для рахунків
`transactions_table_name`	string	Налаштована таблиця для транзакцій
`holdings_table_name`	string \| null	Налаштована таблиця для активів, коли її ввімкнено
`transactions_enabled`	boolean	Чи ввімкнено синхронізацію транзакцій у цю базу
`token_type`	string	`OAUTH`, `PERSONAL` або `DEPRECATED`
`healthy`	boolean	Чи пройшла остання перевірка
`error`	string \| null	Що саме не так, коли `healthy` дорівнює `false`

Кожен запис у google_sheets[]:

Поле	Тип	Значення
`spreadsheet_id`	string	Таблиця, у яку синхронізує Fintable — використовуйте її з власним API Google
`url`	string	Пряме посилання на таблицю
`title`	string	Назва таблиці
`tabs`	object	Налаштовані вкладки `accounts` / `transactions` / `holdings`, кожна у форматі `{sheet, range}` (`null`, якщо не налаштовано)
`healthy`	boolean	Чи пройшла остання перевірка
`error`	string \| null	Що саме не так, коли `healthy` дорівнює `false`

Стан справності надається з кешу перевірок — перший виклик після періоду простою може зайняти кілька секунд, поки виконується перевірка наживо. Налаштуйте інтеграції в розділі Панель → Інтеграції.

Установа

Endpoint	Що робить
`GET /institutions`	Пошук у каталозі (публічний, з пагінацією за зсувом)

Установа — це банк або брокер, до якого Fintable може підключитися: запис у каталозі з можливістю пошуку, що налічує близько 50 000 установ. Каталог публічний — без автентифікації — тож ви можете використовувати його у потоках реєстрації чи для перевірки доступності. Його значення slug використовуються в POST /connections/link.

{
    "data": [
        {
            "slug": "12913262_chase",
            "name": "Chase",
            "domain": "chase.com",
            "supported": true,
            "countries": [
                "US"
            ],
            "coverage_url": "https://fintable.io/coverage/us/12913262_chase",
            "updated_at": "2026-07-19T02:11:36Z"
        }
    ],
    "meta": {
        "page": 1,
        "has_more": true
    }
}

Поле	Тип	Значення
`slug`	string	Ідентифікатор установи — передавайте його в `POST /connections/link`
`name`	string	Видима назва
`domain`	string \| null	Домен вебсайту установи
`supported`	boolean	Чи може Fintable підключитися до неї просто зараз
`countries`	array of strings	Коди країн ISO, у яких вона працює
`coverage_url`	string \| null	Публічна сторінка покриття; `null`, якщо її немає
`updated_at`	string \| null	Коли запис каталогу востаннє змінювався

GET /institutions

Параметри запиту:

Параметр	Значення
`q`	Нечіткий пошук за назвою, мінімум 3 символи
`domain`	Збіг за доменом вебсайту
`country`	Код країни ISO, напр. `US`
`provider`	`PLAID`, `NORDIGEN`, `AKOYA`, `FINICITY`, `MERCURY`, `TABS`, `SNAPTRADE` (GoCardless позначається як `NORDIGEN`; прямі банківські API — як `TABS`)
`page`	Номер сторінки — завжди 10 результатів на сторінку

curl "https://fintable.io/api/v2/institutions?q=chase&country=US"

Це єдиний ендпоїнт API з пагінацією за зсувом — гортайте за допомогою page, доки has_more не стане false.

Курс валют

Endpoint	Що робить
`GET /rates`	Курси за один день (і конвертація)
`GET /rates/timeseries`	Щоденний ряд курсів між двома датами
`GET /rates/currencies`	Доступні коди валют

Курси обміну валют безпосередньо від Європейського центрального банку. Як і каталог установ, вони публічні — без автентифікації, — бо це довідкові дані суспільного надбання. Зручно, щоб показати набір мультивалютних рахунків в одній валюті або оцінити стару транзакцію за курсом, який справді діяв на її дату.

Дві особливості даних ЄЦБ, які варто знати, перш ніж будувати на них:

ЄЦБ публікує курси раз на робочий день, близько 16:00 за центральноєвропейським часом. Внутрішньоденного руху немає, тож опитувати частіше ніж щогодини немає сенсу.
За вихідні та святкові дні даних немає взагалі. Якщо запитати суботу, ви отримаєте попередній робочий день — поле date у відповіді завжди каже, який день використано насправді, тож довіряйте йому, а не тому, що ви надіслали.

{
    "data": {
        "base": "USD",
        "date": "2026-07-27",
        "amount": "1",
        "rates": {
            "EUR": "0.878",
            "GBP": "0.7509"
        }
    }
}

Поле	Тип	Значення
`base`	рядок	Валюта, відносно якої наведені курси
`date`	рядок	Робочий день, за який опубліковано курси — може бути раніший за запитаний
`amount`	рядок	Скільки одиниць `base` сконвертовано; `"1"` (за замовчуванням) дає чисті курси
`rates`	обʼєкт	Код валюти → значення, точними десятковими рядками

GET /rates

Параметри запиту:

Параметр	Значення
`base`	Трилітерний код базової валюти. За замовчуванням `EUR`
`symbols`	Коди для повернення — `USD,GBP` або повторюваний `symbols[]`. Пропустіть, щоб отримати всі
`date`	Історична дата (`YYYY-MM-DD`), починаючи з 1999-01-04. За замовчуванням — остання публікація
`amount`	Сума в `base` для конвертації. За замовчуванням `1`

# Сьогоднішні курси
curl "https://fintable.io/api/v2/rates?base=USD&symbols=EUR,GBP"

# Конвертувати 250 USD у євро
curl "https://fintable.io/api/v2/rates?base=USD&symbols=EUR&amount=250"

# Курс, що діяв у конкретний день
curl "https://fintable.io/api/v2/rates?base=USD&symbols=EUR&date=2024-01-15"

Якщо задано amount, у rates буде саме ця сума після конвертації, а не сирий курс — тому amount і повертається у відповіді.

GET /rates/timeseries

Курс за кожен робочий день у діапазоні. Дні, які ЄЦБ пропустив, просто відсутні в rates — очікуйте прогалини й не сприймайте їх як помилку.

Параметр	Значення
`start`	Перша дата (`YYYY-MM-DD`) — обовʼязково
`end`	Остання дата. За замовчуванням — остання публікація
`base`	Код базової валюти. За замовчуванням `EUR`
`symbols`	Коди для повернення
`amount`	Сума в `base` для конвертації. За замовчуванням `1`

curl "https://fintable.io/api/v2/rates/timeseries?start=2024-01-15&end=2024-01-18&base=USD&symbols=EUR"

{
    "data": {
        "base": "USD",
        "start_date": "2024-01-15",
        "end_date": "2024-01-18",
        "amount": "1",
        "rates": {
            "2024-01-15": { "EUR": "0.91366" },
            "2024-01-16": { "EUR": "0.91895" },
            "2024-01-17": { "EUR": "0.91937" },
            "2024-01-18": { "EUR": "0.91954" }
        }
    }
}

Щонайбільше 366 днів за один запит; довші діапазони повертають 422 з проханням звузити його.

GET /rates/currencies

Усі коди валют, які публікує ЄЦБ, разом із назвами — їх близько 30.

curl "https://fintable.io/api/v2/rates/currencies"

{
    "data": [
        { "code": "AUD", "name": "Australian Dollar" },
        { "code": "BRL", "name": "Brazilian Real" }
    ]
}

Код, якого немає в цьому списку (або який ЄЦБ уже не публікував на запитану дату — наприклад HRK після переходу Хорватії на євро), повертає 422, а не 404.

Ціна акції

Endpoint	Що робить
`GET /prices`	Актуальні ціни щонайбільше для 50 тикерів
`GET /prices/{symbol}`	Актуальна ціна одного тикера
`GET /prices/{symbol}/history`	Історичні бари OHLCV

Ціни акцій, що торгуються в США, теж публічні — без автентифікації. Поєднуйте їх зі своїми інвестиційними активами, щоб оцінити портфель, або з GET /rates, щоб виразити ці значення у власній валюті.

{
    "data": [
        {
            "symbol": "AAPL",
            "price": "183.63",
            "currency": "USD",
            "open": "182.16",
            "high": "184.26",
            "low": "180.93",
            "previous_close": "185.92",
            "change": "-2.29",
            "change_percent": "-1.2317",
            "volume": 65603010,
            "trading_day": "2024-01-16",
            "as_of": "2024-01-16T20:59:59Z",
            "feed": "iex"
        }
    ]
}

Поле	Тип	Значення
`symbol`	рядок	Тикер, завжди у верхньому регістрі
`price`	рядок	Ціна останньої угоди, а за її відсутності — закриття дня
`currency`	рядок	Валюта біржі — USD для акцій США
`open` `high` `low`	рядок \| null	Діапазон поточної торгової сесії
`previous_close`	рядок \| null	Закриття попередньої сесії
`change`	рядок \| null	`price` − `previous_close`
`change_percent`	рядок \| null	Той самий рух у відсотках
`volume`	ціле \| null	Скільки акцій наторговано сьогодні
`trading_day`	рядок \| null	Сесія, до якої належать денні показники
`as_of`	рядок \| null	Коли зафіксовано ціну
`feed`	рядок	Джерело ринкових даних для котирування

Ціни — точні десяткові рядки, як і всі інші числа в цьому API.

На поле feed варто зважати. За замовчуванням це iex: дані беруться лише з біржі IEX, а не зі зведеної стрічки, тож volume — це обсяг саме на IEX, невелика частка реального обсягу торгів, а price може трохи відрізнятися від останньої зведеної угоди. Цього достатньо, щоб оцінити позицію, але це не офіційне котирування. Малоліквідні папери можуть узагалі не торгуватися на IEX того дня — тоді price повертається до ціни закриття.

GET /prices

Параметр	Значення
`symbols`	Тикери через кому — обовʼязково, щонайбільше 50 за запит

curl "https://fintable.io/api/v2/prices?symbols=AAPL,MSFT,NVDA"

Результати повертаються в тому порядку, в якому ви їх запитали. Тикери, для яких немає даних, просто відсутні у відповіді, а не ламають весь запит — тож перевіряйте, що саме повернулося, а не припускайте, що список збігається з надісланим. Маршрут для одного тикера нижче поводиться навпаки: він віддає 404.

GET /prices/{symbol}

Один тикер, той самий обʼєкт, але не загорнутий у масив. Повертає 404, якщо даних про ціну немає.

curl "https://fintable.io/api/v2/prices/AAPL"

GET /prices/{symbol}/history

Історичні бари, скориговані на спліти та дивіденди, — тож багаторічне вікно можна порівнювати від початку до кінця напряму.

Параметр	Значення
`timeframe`	`1min`, `5min`, `15min`, `1hour`, `1day`, `1week`, `1month`. За замовчуванням `1day`
`start`	Перша дата (`YYYY-MM-DD`)
`end`	Остання дата (`YYYY-MM-DD`)
`limit`	Щонайбільше барів, 1–1000. За замовчуванням 1000

curl "https://fintable.io/api/v2/prices/AAPL/history?timeframe=1day&start=2024-01-02&end=2024-01-31"

{
    "data": {
        "symbol": "AAPL",
        "timeframe": "1day",
        "currency": "USD",
        "feed": "iex",
        "bars": [
            {
                "timestamp": "2024-01-02T05:00:00Z",
                "date": "2024-01-02",
                "open": "187.15",
                "high": "188.44",
                "low": "183.89",
                "close": "185.64",
                "volume": 1795262,
                "trade_count": 18557,
                "vwap": "185.9"
            }
        ]
    }
}

Тикер або діапазон без барів повертає 404.

Зворотний зв'язок

Endpoint	Що робить
`POST /feedback`	Надсилає листа команді Fintable і отримує відповідь від людини

Щось зламалося, чогось бракує або щось незрозуміле? Розкажіть нам просто звідти, де ви зараз — з коду, терміналу чи AI-асистента — не відкриваючи сторінку підтримки. Лист потрапляє до тієї самої скриньки, з якою цілий день працює жива команда підтримки, з вашою адресою в Reply-To, і ви отримуєте відповідь протягом 2 робочих днів, зазвичай значно швидше.

POST /feedback

Поле	Тип	Значення
`message`	string	Обов'язкове. Саме повідомлення, 10–10000 символів. Деталі — це те, що робить відповідь корисною (див. нижче)
`subject`	string	Однорядковий підсумок для скриньки
`email`	string	Куди відповісти. Типово — email вашого акаунта
`screenshot`	string	Зображення у base64 (`data:` URL теж підходить): PNG, JPEG, WebP або GIF, до 2 МБ у розкодованому вигляді
`screenshot_filename`	string	Назва вкладення, наприклад `sync-error.png`

Опишіть якомога більше: що ви робили, що сталося, чого очікували натомість, точний текст помилки, які саме connection чи account були задіяні та коли це сталося. Скріншот того, що ви бачите, вартий кількох абзаців. Розпливчасті звернення коштують вам зайвого кола листування.

curl -X POST https://fintable.io/api/v2/feedback \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "subject": "Для брокерського рахунку зникли holdings",
        "message": "acct_1182 синхронізується з травня, але GET /accounts/acct_1182/holdings з 2026-07-28 повертає порожній список. Connection має статус ok і синхронізацію о 2026-08-03T06:12:00Z.",
        "screenshot": "iVBORw0KGgoAAAANSUhEUg..."
      }'

{
    "data": {
        "sent": true,
        "reply_to": "[email protected]",
        "screenshot_attached": true,
        "message": "Thanks — your message is with the Fintable team..."
    }
}

2xx означає, що лист справді надіслано, а не просто поставлено в чергу. Підходить будь-який токен, зокрема лише для читання. Ліміт — 2 на годину і 5 на день, і рахуються лише справді надіслані повідомлення — відхилений запит нічого не витрачає.

Документація та посібник як дані

Endpoint	Що повертає
`GET /guide`	Повний посібник користувача Fintable у форматі markdown
`GET /docs`	Цей документ у форматі markdown
`GET /openapi.json`	Опис цього API у форматі OpenAPI 3.1

Сама документація доступна у вигляді звичайного markdown — зручно, щоб передати її LLM або відрендерити у власних інструментах. Усе публічне, без автентифікації.

GET /guide

Повний посібник користувача Fintable у форматі markdown. ?locale=main|uk|es вибирає мову.

GET /docs

Цей документ у форматі markdown. ?locale=main|uk|es вибирає мову.

GET /openapi.json

Опис цього API у форматі OpenAPI 3.1 — спрямуйте на нього Swagger UI, Postman чи генератор коду.

Домовленості API

Кілька домовленостей діють усюди, тож вивчити їх достатньо один раз.

Конверт відповіді

Списки повертають {"data": [...]}, а окремі об'єкти — {"data": {...}}. Списки транзакцій додатково містять next_cursor (див. Пагінація). Єдиний виняток: публічний каталог установ використовує пагінацію за зсувом і поле meta: {page, has_more}.

Запити мають надсилати Accept: application/json.

Гроші — це рядок

Суми — це точні десяткові рядки ("-4.50", "1234.56"), а не числа з рухомою комою, тож ви ніколи не втратите копійку через округлення. Від'ємні суми — це кошти на вихід. Кожна сума супроводжується окремим полем currency (діюча валюта з урахуванням будь-якого заданого вами перевизначення). Баланси рахунків дотримуються тієї самої домовленості.

Мітки часу та дати

Мітки часу подано в ISO-8601 UTC, як-от 2026-07-26T15:04:05Z. Поля транзакцій date та auth_date — це звичайні рядки YYYY-MM-DD.

Ідентифікатори об'єктів непрозорі

Ідентифікатори — це непрозорі рядки довжиною до 64 символів. Зберігайте їх як є й не намагайтеся видобути з них зміст: наведені нижче форми потрібні для впізнавання, а не для розбору.

Об'єкт	Який має вигляд
Транзакція	`tx_01J0AB...` (у давніх акаунтів можуть бути успадковані числові рядки на кшталт `"48214321"`)
Рахунок	`acc_01J0AB...` (тут теж трапляються успадковані числові рядки)
Актив	`hol_01J0AB...` або успадкований числовий рядок
Категорія	`{name-slug}_{10 літер і цифр}`, напр. `dining-out_aB3xY9k2Lm`
Правило	UUID, напр. `a25a374d-e4d7-4652-aca7-5dd3c3d02d15`
Підключення	`conn_{provider}_{number}`, напр. `conn_plaid_1771845993762884095`

Зіставлення об'єктів API з рядками вашої таблиці

Якщо Fintable уже синхронізує дані в базу Airtable чи Google Sheet, рано чи пізно ви захочете зіставити ті рядки з API — одноразово, щоб перейти на API на наявній базі, або постійно.

Не зіставляйте за датою + сумою + описом. Це спрацює для більшості рядків і мовчки зламається саме на тих, які важливі: два однакові зарплатні перекази в одному тижні таким способом не відрізнити.

Зіставляйте за ext_id. Це те саме значення, яке Fintable записує в ключову колонку кожного призначення синхронізації:

Колонка таблиці	Поле API	Примітки
`**Plaid TX ID`	`ext_id` у Транзакції	Унікальний у межах свого рахунку
`**Plaid Account ID`	`ext_id` у Рахунку	Ідентифікатор рахунку в провайдера

Слово Plaid у цих назвах колонок — успадковане. Їх назвали тоді, коли Plaid був єдиним провайдером, і вони мають ту саму назву для GoCardless, Akoya, SnapTrade й усіх інших. Значення не є ідентифікатором Plaid — це те, як об'єкт називає провайдер, що стоїть за цим підключенням.

ext_id — це не id. id (tx_..., acc_...) — власний ідентифікатор Fintable, і саме його приймають і повертають усі ендпоїнти; ext_id існує лише для цього зіставлення. Вважайте його теж непрозорим: його вигляд залежить від провайдера (ідентифікатор Plaid на кшталт 3k3OMr7qdPtD8oXPPBNZtarZeDDPwwfoPX0ED, складений на кшталт 7863464615930617517--a7a655b9c42ea4f4ad246543c9e9f044 у підключенні GoCardless), і ці форми не є контрактом. Порівнюйте його, не розбирайте.

Саме на рахунках це найчастіше підводить. **Plaid Account ID — це не account_id з API. account_id транзакції — це ідентифікатор рахунку у Fintable, те саме значення, що й id у Рахунку, тоді як колонка таблиці містить ідентифікатор провайдера, тобто ext_id того самого рахунку. Це два різні значення для одного рахунку, тож зіставлення вашої таблиці рахунків за account_id мовчки не знайде нічого. Зіставляйте за ext_id: GET /accounts повертає обидва, тож один прохід по ньому дає вам таблицю відповідності.

Помилки

Кожна відповідь, що не належить до 2xx, має рівно одну структуру, тож один обробник помилок покриває весь API:

{
    "error": {
        "type": "not_found",
        "message": "No transaction with that id."
    }
}

Помилки валідації (422) додатково містять повідомлення для кожного поля:

{
    "error": {
        "type": "validation_failed",
        "message": "The given data was invalid.",
        "errors": {
            "sync_start_date": [
                "Trial accounts can sync at most 30 days of history."
            ]
        }
    }
}

HTTP	`type`	Коли ви це побачите
400	`bad_request` / `invalid_cursor`	Некоректний запит; або курсор, повторно використаний з іншим порядком сортування
401	`unauthenticated`	Токен відсутній, прострочений або відкликаний
403	`forbidden`	Токен дійсний, але дія не дозволена (напр. синхронізація на безкоштовному акаунті)
404	`not_found`	Такого об'єкта немає — зокрема об'єкти, що належать іншому акаунту
405	`method_not_allowed`	Неправильний HTTP-метод
409	`conflict`	Дія конфліктує з поточним станом (напр. видалення категорії, яку ще використовують правила)
413	`payload_too_large`	Тіло запиту перевищує ліміт
422	`validation_failed`	Запит зрозумілий, але якесь поле некоректне
429	`rate_limited`	Пригальмуйте — надходить із заголовком `Retry-After`
500	`server_error`	Наша провина; спробуйте ще раз або зв'яжіться з нами
503	`service_unavailable`	Тимчасовий збій або технічні роботи

Ліміти частоти

Ліміти щедрі для ввічливих, коректно написаних клієнтів; ви натрапите на них, лише якщо надто активно довбите якийсь ендпоїнт. Кожен маршрут має рівно один кошик, а виклики MCP-інструментів витрачають ті самі кошики, що й їхні REST-відповідники. Коли ви досягаєте ліміту, отримуєте 429 із заголовком Retry-After — дотримуйтеся його.

Кошик	Ліміт
Автентифіковані читання	300/хв на токен
Загальні записи (PATCH/DELETE, категорії)	60/хв на акаунт
Створення/оновлення правил	12/год на акаунт
`POST /sync` (і для окремого підключення)	Personal/Trial: 2/день · Office/Enterprise: 1/год
`POST /connections/link` (і перепідключення)	1/хв на акаунт
`PATCH /transactions/bulk`	10/год на акаунт
`POST /categorizer/sync`	6/день на акаунт
`POST /feedback`	2/годину і 5/день на акаунт (лише надіслані повідомлення)
Публічний `GET /institutions`	60/хв на IP
Публічний `GET /rates` (і `/rates/*`)	60/хв на IP
Публічний `GET /prices` (і `/prices/*`)	60/хв на IP
Публічні `/guide`, `/docs`, `openapi.json`	60/хв на IP
MCP-ендпоїнт	120/хв на токен
`POST /oauth/register`	5/год на IP

Кешування

Автентифіковані відповіді завжди віддаються свіжими (Cache-Control: no-store). Публічні ендпоїнти (/institutions, /guide, /docs, /rates, /prices) можна кешувати до однієї години. Це стосується й цін акцій, тож котирування може відставати від ринку до години — кожна ціна має поле as_of, яке каже, коли її насправді зафіксовано. Цього вистачає, щоб оцінити портфель, але не для торгівлі.

Пагінація

Роки історії транзакцій можуть налічувати десятки тисяч рядків, тож GET /transactions (і варіант для окремого рахунку) ніколи не повертає все одразу — він використовує пагінацію з непрозорим курсором. Чому курсор, а не номери сторінок? Бо ваші дані рухаються: синхронізація може додавати чи оновлювати транзакції, поки ви гортаєте, і сторінки за зсувом мовчки пропускали б або дублювали рядки. Курсор фіксує вашу точну позицію в послідовності, тож повний обхід бачить кожен рядок рівно один раз.

Запросіть сторінку — і якщо є ще, відповідь підкаже, звідки продовжити:

curl "https://fintable.io/api/v2/transactions?limit=100" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
    "data": [
        "... 100 transactions ..."
    ],
    "next_cursor": "eyJ2IjoxLCJvIjoiZGF0ZSIsazoi..."
}

Передайте курсор назад, щоб отримати наступну сторінку, і повторюйте, доки next_cursor не стане null:

curl "https://fintable.io/api/v2/transactions?cursor=eyJ2IjoxLC..." \
  -H "Authorization: Bearer YOUR_TOKEN"

Правила:

limit за замовчуванням дорівнює 100 і не може перевищувати 500.
Курсори непрозорі й прив'язані до свого порядку сортування. Курсор, створений у списку з order=date, відхиляється (400 invalid_cursor), якщо його повторно використати з order=updated, і навпаки.
Типовий порядок — від найновіших за датою транзакції.

Інкрементна синхронізація

Якщо ви дзеркалите транзакції у власну базу даних чи застосунок, повторне завантаження всієї історії лише заради вчорашніх змін — повільно й марнотратно, та й ліміти частоти не розраховані на це. Інкрементна синхронізація — ефективна альтернатива: кожна транзакція має мітку updated_at, а ендпоїнт списку вміє сортувати за нею, тож ви можете запросити рівно «усе, що змінилося відтоді, як я дивився востаннє».

Опитування змін

Опитуйте з ?order=updated&updated_since=<мітка часу ISO>. Результати повертаються відсортованими за зростанням updated_at, з тією самою курсорною пагінацією, що й вище. Рецепт:

Викличте GET /transactions?order=updated&updated_since=2026-07-25T00:00:00Z.
Пройдіть сторінки за допомогою next_cursor, обробляючи кожну транзакцію.
Запам'ятайте найбільше значення updated_at, яке ви обробили; використайте його як наступне updated_since.

Чесний дрібний шрифт: видалення

Видалення непомітні для інкрементного опитування — жодних «надгробків» чи журналу видалень не існує. Дві ситуації, які варто передбачити:

Ми працюємо над кращим рішенням, яке зробить видалення видимими. А поки наша найкраща порада — не завантажувати очікувані транзакції: використовуйте pending=false, коли переносите транзакції у власну базу даних чи застосунок.

Плинність очікуваних транзакцій. Очікувані транзакції можуть бути замінені після проведення (новий ідентифікатор, скоригована сума чи дата). Якщо ви все ж їх імпортуєте, періодично перезавантажуйте вікно останніх 30 днів, щоб це вловити.
Видалення цілих рахунків. Коли рахунок зникає з GET /accounts або переходить у enabled: false, відкиньте всі транзакції, які ви кешували для цього рахунку.

Якщо вам потрібна більша певність, періодично перезавантажуйте все повністю.

Запитання чи відгуки?

Якщо щось тут незрозуміле, чогось бракує або щось просто неправильне — ми хочемо про це знати: надішліть це просто з коду через POST /feedback (або попросіть свого AI-асистента скористатися MCP-інструментом feedback), напишіть нам або скористайтеся бульбашкою підтримки на будь-якій сторінці. Якщо ви створюєте щось на основі API, ми залюбки допоможемо вам це запустити.