> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Отримання Записів

<Tip>Ми надаємо розробникам вбудований [Конструктор параметрів запиту](https://app.teable.ai/developer/tool/query-builder), який допомагає створювати власні запити на основі наявних Таблиць.</Tip>

### Шлях

GET /api/table/\{tableId}/record
​

### Запит

#### Параметри шляху

tableId (string): Унікальний ідентифікатор Таблиці [(як знайти)](/uk/api-doc/get-id#tableid).

#### Основні параметри запиту

Усі параметри необов’язкові

<ParamField query="viewId" type="string">
  Визначає ідентифікатор Перегляду, з якого потрібно отримати Записи. Якщо його не вказано, Записи повертаються в порядку часу створення, разом з усіма Записами та Полями.
</ParamField>

<ParamField query="take" type="number">
  Визначає кількість Записів, які потрібно отримати; максимальне значення — 100. Щоб прочитати більше Записів, переходьте між сторінками даних за допомогою `skip` і `take` (див. [Пагінація](/uk/api-doc/overview)).

  Обмеження у 100 Записів застосовується до персональних ключів API Teable Cloud, створених 10 вересня 2026 року або пізніше. Ключі, створені до цієї дати, токени OAuth і плагінів, а також самостійно розгорнуті екземпляри й надалі підтримують до 1000 Записів, однак рекомендований розмір сторінки становить 100 Записів.
</ParamField>

<ParamField query="skip" type="number">
  Визначає кількість Записів, які потрібно пропустити; використовується для пагінації.
</ParamField>

<ParamField query="fieldKeyType" type="string" default="name">
  Визначає тип ключів Полів у Записах. Можливі значення:

  * `name`: використовувати назви Полів як ключі (за замовчуванням)
  * `id`: використовувати ідентифікатори Полів як ключі
  * `dbFieldName`: використовувати значення dbFieldName Полів як ключі
</ParamField>

<ParamField query="cellFormat" type="string" default="json">
  Визначає формат повернення значень комірок. Можливі значення:

  * `json`: повертає структуровані дані JSON (за замовчуванням)
  * `text`: повертає дані у форматі звичайного тексту
</ParamField>

<ParamField query="projection" type="string[]">
  Якщо потрібні лише певні Поля, укажіть їх у цьому параметрі. Інакше буде отримано всі видимі Поля. Значення параметра залежать від налаштування fieldKeyType (використовуються назви Полів, їхні ідентифікатори або dbFieldName).
</ParamField>

<ParamField query="orderBy" type="string">
  Масив об’єктів сортування, що визначають порядок Записів.
</ParamField>

<ParamField query="filter" type="string">
  Об’єкт складної умови запиту для фільтрування результатів. Підтримує складні умови запиту на основі Полів, операторів і значень.
</ParamField>

<ParamField query="search" type="string[]">
  Пошук Записів, що відповідають указаним Полям і значенням.
</ParamField>

<Accordion title="Розширені параметри запиту">
  <ParamField query="groupBy" type="string">
    Масив об’єктів групування, що визначають спосіб групування Записів.
  </ParamField>

  <ParamField query="collapsedGroupIds" type="string[]">
    Масив ідентифікаторів груп, які потрібно згорнути.
  </ParamField>

  <ParamField query="selectedRecordIds" type="string[]">
    Фільтрує вибрані Записи за їхніми ідентифікаторами.
  </ParamField>

  <ParamField query="ignoreViewQuery" type="boolean">
    Якщо вказано viewId, установлення цього параметра в значення true призведе до ігнорування фільтрів, сортування та інших налаштувань Перегляду.
  </ParamField>

  <ParamField query="filterLinkCellCandidate" type="string[]">
    Фільтрує Записи з пов’язаної Таблиці, які можна вибрати за допомогою вказаної комірки зв’язку. Наприклад, для Полів зі зв’язком «один до багатьох» або «один до одного» вже вибрані ідентифікатори Записів не відображатимуться.
  </ParamField>

  <ParamField query="filterLinkCellSelected" type="string[]">
    Фільтрує Записи з пов’язаної Таблиці, які вже вибрано за допомогою цієї комірки зв’язку. Примітка: у цьому випадку viewId, filter і orderBy не діятимуть, оскільки вибрані Записи мають власний порядок.
  </ParamField>
</Accordion>