---
title: "Get Row List"
method: GET
path: "/v3.0/rows/"
tags: ["rows"]
---

# Get Row List

`GET /v3.0/rows/`

## Request

- Base URL: `https://api.formaloo.me`
- URL: `https://api.formaloo.me/v3.0/rows/`
- Auth: none declared. Required headers: `x-api-key`

## Query parameters

- `page` integer
- `search` string
- `submit_number` string
- `tags` string
- `tracking_code` string

## Headers

- `x-api-key` string, required
- `x-workspace` string

## Response `200`

- PaginatedRowSearchList
  - `count` integer
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `page_size` integer
  - `page_count` integer
  - `current_page` integer
  - `rows` RowSearch[]
    - `form` FormShort, required
      - `submit_start_time` string, date-time, nullable
      - `submit_end_time` string, date-time, nullable
      - `forward_submit_emails_to` object
      - `subdomain` string
      - `owner_custom_domain` string
      - `deleted` string, date-time
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `slug` string, nullable
      - `address` string, nullable: A unique string to identify form for users. It's auto-generated if not set by user.
      - `title` string, nullable: the form's display name.
      - `show_title` boolean: title visibility on form.
      - `description` string, nullable: a description about form.
      - `success_message` string, nullable: a messages to show if the form is successfully submitted.
      - `error_message` string, nullable: a messages to show if the form is not successfully submitted.
      - `button_text` string, nullable: a text to show on the form's submit button.
      - `localized_content` object, nullable: localized content
      - `needs_login` boolean: whether the users need to login to submit the form.
      - `time_limit` string, time, nullable: time limit to fill this form
      - `shuffle_fields` boolean: shows wether to shuffle the ordering of the form field on show.
      - `form_redirects_after_submit` string, nullable: Either null or the url of destination.
      - `include_data_on_redirect` boolean: if set true, the submitted data along with aliases will be included in the redirect url.
      - `has_recaptcha` boolean: defines if show a recaptcha on form or not
      - `row_update_email_notif` boolean: receive email notifications when a row is updated.
      - `generate_pdf_for_admin` boolean: whether to generate a pdf after each submit.
      - `generate_pdf_for_user` boolean: whether to generate a pdf after each submit.
      - `slack_accesses` object, nullable: List of slack access slugs.
      - `form_type` 'simple' | 'multi_step' | 'nps'
      - `thumbnail` string, uri, nullable: an optional thumbnail for the form
      - `logo` string, uri, nullable: the logo to be shown on the top of form
      - `logo_slug` string, nullable: the logo's slug.
      - `logo_url` string, nullable: the logo's url.
      - `logo_position` 'left' | 'center' | 'right'
      - `text_color` string, nullable: the form's text color.
      - `button_color` string, nullable: the form's button color.
      - `theme_color` string, nullable: the form's theme color.
      - `theme_name` string, nullable: the form's theme name.
      - `field_color` string, nullable: the form's field color.
      - `background_color` string, nullable: the form's background color.
      - `border_color` string, nullable: the form's border color.
      - `submit_text_color` string, nullable: the form's submit text color.
      - `background_image` string, uri, nullable: background image for this form.
      - `background_image_slug` string, nullable: the background image's slug.
      - `background_image_url` string, nullable: the background image's url.
      - `banner_slug` string, nullable: the banner's slug.
      - `banner_url` string, nullable: the banner's url.
      - `meta_image_slug` string, nullable: meta image's slug.
      - `meta_image_url` string, nullable: meta image's url.
      - `favicon_slug` string, nullable: favicon's slug.
      - `favicon_url` string, nullable: favicon's url.
      - `theme_config` object: the form's additional theme configuration.
      - `custom_js` string, nullable
      - `custom_css` string, nullable
      - `version` string: version of form
      - `config` string, nullable: the form's additional configuration.
      - `show_calculations_score_result` boolean: to show calculations result after user submits a form
      - `show_submit_tracking_code` boolean: whether to show the tracking code after user has submitted the form.
      - `assign_submit_number` boolean: if set to true, each new row will have an incremental submit number starting from 1.
      - `show_answers` boolean: whether to show the reslts page containing answers and answer sheet after form submit.
      - `form_currency_type` 'dollar' | 'USD' | 'EUR' | 'GBP' | 'AUD' | 'CAD' | 'CHF' | 'NOK' | 'SEK' | 'DKK' | 'MXN' | 'NZD' | 'BRL' | 'JPY' | 'INR' | 'AED' | 'IDR' | 'SGD'
      - `position` integer: forms position in relation to other forms.
      - `public_stats` boolean: if set true, form stats will be publicly shared by a link.
      - `public_rows` boolean: if set true, submitted data will be publicly shared by a link.
      - `address_is_universal` boolean: If set true, form's address should be universally unique, and the forms is accessible on the root domain, otherwise, it's only available on the user's domain and subdomain.
      - `custom_domain` string, nullable: user can set this on the form, if they want to show this form on a custom domain (e.g. https://example.co/).
      - `accept_draft_answers` boolean: users can have draft answers on this form or not.
      - `meta_tags` string, nullable: the form's meta tags, which will be added to all pages related to this form.
      - `ai_mode` boolean
      - `meta_description` string, nullable: Meta description for the form.
      - `auto_translation_enabled` boolean
      - `allow_indexing` boolean
      - `run_field_logics_on_update` boolean: Whether to run field logics on row update or not.
      - `spreadsheet_id` string, nullable: id for the corresponding google sheet.
      - `spreadsheet_url` string, nullable: url for the corresponding google sheet.
      - `is_google_integration_enabled` boolean: whether google sheets integration is enabled for this form.
      - `last_submit_time` string, date-time, nullable: when was the last submit on the form?
      - `total_submits_count` integer: shows how many submits the form has.
      - `total_size` integer: shows total size of the form and it's fields' fields in bytes.
      - `create_type` 'api' | 'excel' | 'google_forms' | 'google_sheets' | 'magic_import' | 'magic_create' | 'recurring_submission'
      - `primary_field` integer, nullable
    - `row_tags` RowTag[], required
      - `slug` string, nullable
      - `title` string, required
      - `color` string, nullable: category color settings or color code.
    - `rendered_data` object
    - `data` string
    - `slug` string, nullable
    - `submit_code` string, nullable: a submit code to provide to user.
    - `tracking_code` string, nullable: a tracking code to provide to end user. unique for each row in the form.
    - `submit_number` integer
    - `language` LanguageShort
      - `slug` string, nullable
      - `title` string, required
      - `code` string, nullable
      - `is_default` boolean: set true to set this language as the default language for the new forms.
      - `direction` 'ltr' | 'rtl'
    - `position` number, double, nullable: position of row in table.
    - `pdf_link` string, uri, nullable
    - `created_by` string
    - `updated_by` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `submit_time` string, time, nullable: time it took to fill this form
    - `submitter_referer_address` string, nullable: which website was this request submitted on
    - `email_verification_state` 'not_required' | 'not_verified' | 'verified'
    - `calculation_score` object, nullable: shows the sum of scores for each field in row. it is null if there is not any calculations
    - `create_type` 'api' | 'excel' | 'google_forms' | 'google_sheets' | 'magic_import' | 'magic_create' | 'recurring_submission'
    - `status` 'draft' | 'submit' | 'expired'
    - `user` integer, nullable: the user who has submitted the form.

---

[API](https://skmtc.dev/formaloo/apis/formaloo-api-documentation.md) · [All operations](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/revisions/47b268aeb656?raw)
