form-displays

Get Form

get/v3.0/form-displays/slug/{slug}/

Request

  • Base URL: https://api.formaloo.me
  • URL: https://api.formaloo.me/v3.0/form-displays/slug/{slug}/
  • Auth: none declared. Required headers: x-api-key

Path parameters

slugstring required

Headers

x-api-keystring required

The application secret provided to the client.

Response

submit_start_timestring date-time nullable
submit_end_timestring date-time nullable
fieldsobject
fields_listobject
has_watermarkboolean
recaptcha_codestring
logicobject
full_form_addressstring
logic_metadataobject
visit_countinteger
subdomainstring
owner_custom_domainstring
combined_localized_contentstring
login_requiredstring
businessstring
created_atstring date-time
updated_atstring date-time
slugstring nullable
addressstring nullable

A unique string to identify form for users. It's auto-generated if not set by user.

titlestring nullable

the form's display name.

show_titleboolean

title visibility on form.

descriptionstring nullable

a description about form.

success_messagestring nullable

a messages to show if the form is successfully submitted.

error_messagestring nullable

a messages to show if the form is not successfully submitted.

button_textstring nullable

a text to show on the form's submit button.

localized_contentobject nullable

localized content

save_ai_responseboolean

whether to save the AI response on the row or not.

needs_loginboolean

whether the users need to login to submit the form.

time_limitstring time nullable

time limit to fill this form

shuffle_fieldsboolean

shows wether to shuffle the ordering of the form field on show.

form_redirects_after_submitstring nullable

Either null or the url of destination.

include_data_on_redirectboolean

if set true, the submitted data along with aliases will be included in the redirect url.

has_recaptchaboolean

defines if show a recaptcha on form or not

row_update_email_notifboolean

receive email notifications when a row is updated.

generate_pdf_for_adminboolean

whether to generate a pdf after each submit.

generate_pdf_for_userboolean

whether to generate a pdf after each submit.

form_type'simple' | 'multi_step' | 'nps'
thumbnailstring uri nullable

an optional thumbnail for the form

logostring uri nullable

the logo to be shown on the top of form

logo_slugstring nullable

the logo's slug.

logo_urlstring nullable

the logo's url.

logo_position'left' | 'center' | 'right'
text_colorstring nullable

the form's text color.

button_colorstring nullable

the form's button color.

theme_colorstring nullable

the form's theme color.

field_colorstring nullable

the form's field color.

background_colorstring nullable

the form's background color.

border_colorstring nullable

the form's border color.

submit_text_colorstring nullable

the form's submit text color.

background_imagestring uri nullable

background image for this form.

background_image_slugstring nullable

the background image's slug.

background_image_urlstring nullable

the background image's url.

banner_slugstring nullable

the banner's slug.

banner_urlstring nullable

the banner's url.

meta_image_slugstring nullable

meta image's slug.

meta_image_urlstring nullable

meta image's url.

favicon_slugstring nullable

favicon's slug.

favicon_urlstring nullable

favicon's url.

theme_configobject

the form's additional theme configuration.

custom_jsstring nullable
custom_cssstring nullable
versionstring

version of form

configstring nullable

the form's additional configuration.

show_calculations_score_resultboolean

to show calculations result after user submits a form

show_submit_tracking_codeboolean

whether to show the tracking code after user has submitted the form.

assign_submit_numberboolean

if set to true, each new row will have an incremental submit number starting from 1.

show_answersboolean

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'
positioninteger

forms position in relation to other forms.

public_statsboolean

if set true, form stats will be publicly shared by a link.

public_rowsboolean

if set true, submitted data will be publicly shared by a link.

address_is_universalboolean

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_domainstring 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_answersboolean

users can have draft answers on this form or not.

should_have_primary_boardboolean

whether we should create a primary board for this form

meta_tagsstring nullable

the form's meta tags, which will be added to all pages related to this form.

ai_modeboolean
meta_descriptionstring nullable

Meta description for the form.

auto_translation_enabledboolean
allow_indexingboolean
run_field_logics_on_updateboolean

Whether to run field logics on row update or not.

is_google_integration_enabledboolean

whether google sheets integration is enabled for this form.

last_submit_timestring date-time nullable

when was the last submit on the form?

total_submits_countinteger

shows how many submits the form has.

total_sizeinteger

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'
categoryinteger nullable
primary_fieldinteger nullable

Changes

No recorded changes to this operation across all 1 revision of this API.