Forms
List forms
Lists your company’s forms, newest first, with each form’s type, status, countries, components, styles, and response count. This list is paginated by page number. Send page (default 1) and per_page (default 20); pagination in the response reports the current page, total pages, and total count. Narrow the list with with_status, with_form_type, and search_query, and order it with sorted_by; the filters combine, and a blank value means no filter.
GET
/
api
/
forms
List forms
curl --request GET \
--url https://api.fluid.app/api/forms \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/forms"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fluid.app/api/forms', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/forms",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/forms"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fluid.app/api/forms")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/forms")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": 4136,
"title": "Enrollment - Canada",
"status": "active",
"description": "Tax and payout details we need before we can pay your commissions in Canada.",
"form_type": "post_purchase",
"form_redirect": null,
"updated_at": "2026-10-07T15:31:40Z",
"form_components": "[{\"element_type\":\"input\",\"puck_type\":\"legal_name\",\"label\":\"Legal name\",\"placeholder\":\"As it appears on your tax return\",\"required\":true,\"sensitive_info\":false,\"is_form_field\":true,\"id\":18321},{\"element_type\":\"input\",\"puck_type\":\"date_of_birth\",\"label\":\"Date of birth\",\"placeholder\":\"MM/DD/YYYY\",\"required\":true,\"sensitive_info\":true,\"is_form_field\":true,\"id\":18322},{\"element_type\":\"short_text_entry\",\"puck_type\":\"short_text_entry\",\"label\":\"Social Insurance Number (SIN)\",\"placeholder\":\"123 456 789\",\"required\":true,\"sensitive_info\":true,\"is_form_field\":true,\"id\":18323},{\"element_type\":\"multiple_choice_entry\",\"puck_type\":\"multiple_choice_entry\",\"label\":\"How did you hear about Dunder Mifflin?\",\"required\":false,\"sensitive_info\":false,\"is_form_field\":true,\"multiple_choice_options\":[{\"label\":\"Social media\"},{\"label\":\"A friend or family member\"},{\"label\":\"A rep\"},{\"label\":\"Search\"},{\"label\":\"An event\"},{\"label\":\"Other\"}],\"id\":18324}]",
"countries": [
{
"id": 39,
"name": "Canada",
"iso": "CA"
}
],
"form_styles": null,
"form_respondents_count": 0,
"public_token": "c9Lw2Rk7VbN4xQe8ZtYm3A",
"embed_settings": {
"password_protected": false
},
"embed_url": "https://forms.fluid.app/c9Lw2Rk7VbN4xQe8ZtYm3A?embed=true",
"share_url": "https://forms.fluid.app/c9Lw2Rk7VbN4xQe8ZtYm3A"
},
{
"id": 4132,
"title": "Scranton Business Park open house",
"status": "active",
"description": "RSVP for the Scranton Business Park open house on November 12.",
"form_type": null,
"form_redirect": null,
"updated_at": "2026-10-06T20:11:35Z",
"form_components": null,
"countries": [
{
"id": 233,
"name": "United States",
"iso": "US"
}
],
"form_styles": null,
"form_respondents_count": 0,
"public_token": null,
"embed_settings": {
"password_protected": false
},
"embed_url": null,
"share_url": null
},
{
"id": 4130,
"title": "Customer survey - Fall 2026",
"status": "active",
"description": "Tell us how your last Dunder Mifflin paper order went.",
"form_type": null,
"form_redirect": null,
"updated_at": "2026-08-03T13:10:05Z",
"form_components": "[{\"element_type\":\"multiple_choice_entry\",\"puck_type\":\"multiple_choice_entry\",\"label\":\"How did you hear about Dunder Mifflin?\",\"required\":false,\"sensitive_info\":false,\"is_form_field\":true,\"multiple_choice_options\":[{\"label\":\"Social media\"},{\"label\":\"A friend or family member\"},{\"label\":\"A rep\"},{\"label\":\"Search\"},{\"label\":\"An event\"},{\"label\":\"Other\"}],\"id\":18341},{\"element_type\":\"long_text_entry\",\"puck_type\":\"long_text_entry\",\"label\":\"Anything else?\",\"placeholder\":\"Tell us what we could do better\",\"required\":false,\"sensitive_info\":false,\"is_form_field\":true,\"id\":18342}]",
"countries": [
{
"id": 233,
"name": "United States",
"iso": "US"
}
],
"form_styles": null,
"form_respondents_count": 48,
"public_token": "pT6hW1zK8sDf3GjQ9vBn2L",
"embed_settings": {
"password_protected": false
},
"embed_url": "https://forms.fluid.app/pT6hW1zK8sDf3GjQ9vBn2L?embed=true",
"share_url": "https://forms.fluid.app/pT6hW1zK8sDf3GjQ9vBn2L"
},
{
"id": 4127,
"title": "Enrollment - United States",
"status": "active",
"description": "Tax and payout details we need before we can pay your commissions.",
"form_type": "post_purchase",
"form_redirect": null,
"updated_at": "2026-09-14T17:22:48Z",
"form_components": "[{\"element_type\":\"input\",\"puck_type\":\"legal_name\",\"label\":\"Legal name\",\"placeholder\":\"As it appears on your tax return\",\"required\":true,\"sensitive_info\":false,\"is_form_field\":true,\"id\":18301},{\"element_type\":\"input\",\"puck_type\":\"date_of_birth\",\"label\":\"Date of birth\",\"placeholder\":\"MM/DD/YYYY\",\"required\":true,\"sensitive_info\":true,\"is_form_field\":true,\"id\":18302},{\"element_type\":\"file_download\",\"puck_type\":\"file_download\",\"header_text\":\"Blank W-9\",\"sub_text\":\"Download the W-9, fill it in, and sign it.\",\"file_download_url\":\"https://www.irs.gov/pub/irs-pdf/fw9.pdf\",\"required\":false,\"is_form_field\":true,\"id\":18303},{\"element_type\":\"file_upload\",\"puck_type\":\"file_upload\",\"label\":\"Signed W-9\",\"required\":true,\"sensitive_info\":true,\"is_form_field\":true,\"id\":18304},{\"element_type\":\"multiple_choice_entry\",\"puck_type\":\"multiple_choice_entry\",\"label\":\"How did you hear about Dunder Mifflin?\",\"required\":false,\"sensitive_info\":false,\"is_form_field\":true,\"multiple_choice_options\":[{\"label\":\"Social media\"},{\"label\":\"A friend or family member\"},{\"label\":\"A rep\"},{\"label\":\"Search\"},{\"label\":\"An event\"},{\"label\":\"Other\"}],\"id\":18305}]",
"countries": [
{
"id": 233,
"name": "United States",
"iso": "US"
}
],
"form_styles": null,
"form_respondents_count": 2,
"public_token": "Xk3vP9qLm2RtW8yZb5NcJg",
"embed_settings": {
"password_protected": false
},
"embed_url": "https://forms.fluid.app/Xk3vP9qLm2RtW8yZb5NcJg?embed=true",
"share_url": "https://forms.fluid.app/Xk3vP9qLm2RtW8yZb5NcJg"
}
],
"pagination": {
"current_page": 1,
"total_pages": 1,
"total_count": 4,
"per_page": 20
},
"filters": {
"sorted_by": [
[
"Created At (Newest First)",
"created_at_desc"
],
[
"Created At (Oldest First)",
"created_at_asc"
],
[
"Title (A-Z)",
"title_asc"
],
[
"Title (Z-A)",
"title_desc"
]
]
},
"meta": {
"request_id": "5d0c9a7e-2f41-4b8d-9e36-c1a7f0b2d843",
"timestamp": "2026-10-07T15:40:02Z"
}
}
Query Parameters
Response
object | null
Success
⌘I
List forms
curl --request GET \
--url https://api.fluid.app/api/forms \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fluid.app/api/forms"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fluid.app/api/forms', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/forms",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/forms"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fluid.app/api/forms")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/forms")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": 4136,
"title": "Enrollment - Canada",
"status": "active",
"description": "Tax and payout details we need before we can pay your commissions in Canada.",
"form_type": "post_purchase",
"form_redirect": null,
"updated_at": "2026-10-07T15:31:40Z",
"form_components": "[{\"element_type\":\"input\",\"puck_type\":\"legal_name\",\"label\":\"Legal name\",\"placeholder\":\"As it appears on your tax return\",\"required\":true,\"sensitive_info\":false,\"is_form_field\":true,\"id\":18321},{\"element_type\":\"input\",\"puck_type\":\"date_of_birth\",\"label\":\"Date of birth\",\"placeholder\":\"MM/DD/YYYY\",\"required\":true,\"sensitive_info\":true,\"is_form_field\":true,\"id\":18322},{\"element_type\":\"short_text_entry\",\"puck_type\":\"short_text_entry\",\"label\":\"Social Insurance Number (SIN)\",\"placeholder\":\"123 456 789\",\"required\":true,\"sensitive_info\":true,\"is_form_field\":true,\"id\":18323},{\"element_type\":\"multiple_choice_entry\",\"puck_type\":\"multiple_choice_entry\",\"label\":\"How did you hear about Dunder Mifflin?\",\"required\":false,\"sensitive_info\":false,\"is_form_field\":true,\"multiple_choice_options\":[{\"label\":\"Social media\"},{\"label\":\"A friend or family member\"},{\"label\":\"A rep\"},{\"label\":\"Search\"},{\"label\":\"An event\"},{\"label\":\"Other\"}],\"id\":18324}]",
"countries": [
{
"id": 39,
"name": "Canada",
"iso": "CA"
}
],
"form_styles": null,
"form_respondents_count": 0,
"public_token": "c9Lw2Rk7VbN4xQe8ZtYm3A",
"embed_settings": {
"password_protected": false
},
"embed_url": "https://forms.fluid.app/c9Lw2Rk7VbN4xQe8ZtYm3A?embed=true",
"share_url": "https://forms.fluid.app/c9Lw2Rk7VbN4xQe8ZtYm3A"
},
{
"id": 4132,
"title": "Scranton Business Park open house",
"status": "active",
"description": "RSVP for the Scranton Business Park open house on November 12.",
"form_type": null,
"form_redirect": null,
"updated_at": "2026-10-06T20:11:35Z",
"form_components": null,
"countries": [
{
"id": 233,
"name": "United States",
"iso": "US"
}
],
"form_styles": null,
"form_respondents_count": 0,
"public_token": null,
"embed_settings": {
"password_protected": false
},
"embed_url": null,
"share_url": null
},
{
"id": 4130,
"title": "Customer survey - Fall 2026",
"status": "active",
"description": "Tell us how your last Dunder Mifflin paper order went.",
"form_type": null,
"form_redirect": null,
"updated_at": "2026-08-03T13:10:05Z",
"form_components": "[{\"element_type\":\"multiple_choice_entry\",\"puck_type\":\"multiple_choice_entry\",\"label\":\"How did you hear about Dunder Mifflin?\",\"required\":false,\"sensitive_info\":false,\"is_form_field\":true,\"multiple_choice_options\":[{\"label\":\"Social media\"},{\"label\":\"A friend or family member\"},{\"label\":\"A rep\"},{\"label\":\"Search\"},{\"label\":\"An event\"},{\"label\":\"Other\"}],\"id\":18341},{\"element_type\":\"long_text_entry\",\"puck_type\":\"long_text_entry\",\"label\":\"Anything else?\",\"placeholder\":\"Tell us what we could do better\",\"required\":false,\"sensitive_info\":false,\"is_form_field\":true,\"id\":18342}]",
"countries": [
{
"id": 233,
"name": "United States",
"iso": "US"
}
],
"form_styles": null,
"form_respondents_count": 48,
"public_token": "pT6hW1zK8sDf3GjQ9vBn2L",
"embed_settings": {
"password_protected": false
},
"embed_url": "https://forms.fluid.app/pT6hW1zK8sDf3GjQ9vBn2L?embed=true",
"share_url": "https://forms.fluid.app/pT6hW1zK8sDf3GjQ9vBn2L"
},
{
"id": 4127,
"title": "Enrollment - United States",
"status": "active",
"description": "Tax and payout details we need before we can pay your commissions.",
"form_type": "post_purchase",
"form_redirect": null,
"updated_at": "2026-09-14T17:22:48Z",
"form_components": "[{\"element_type\":\"input\",\"puck_type\":\"legal_name\",\"label\":\"Legal name\",\"placeholder\":\"As it appears on your tax return\",\"required\":true,\"sensitive_info\":false,\"is_form_field\":true,\"id\":18301},{\"element_type\":\"input\",\"puck_type\":\"date_of_birth\",\"label\":\"Date of birth\",\"placeholder\":\"MM/DD/YYYY\",\"required\":true,\"sensitive_info\":true,\"is_form_field\":true,\"id\":18302},{\"element_type\":\"file_download\",\"puck_type\":\"file_download\",\"header_text\":\"Blank W-9\",\"sub_text\":\"Download the W-9, fill it in, and sign it.\",\"file_download_url\":\"https://www.irs.gov/pub/irs-pdf/fw9.pdf\",\"required\":false,\"is_form_field\":true,\"id\":18303},{\"element_type\":\"file_upload\",\"puck_type\":\"file_upload\",\"label\":\"Signed W-9\",\"required\":true,\"sensitive_info\":true,\"is_form_field\":true,\"id\":18304},{\"element_type\":\"multiple_choice_entry\",\"puck_type\":\"multiple_choice_entry\",\"label\":\"How did you hear about Dunder Mifflin?\",\"required\":false,\"sensitive_info\":false,\"is_form_field\":true,\"multiple_choice_options\":[{\"label\":\"Social media\"},{\"label\":\"A friend or family member\"},{\"label\":\"A rep\"},{\"label\":\"Search\"},{\"label\":\"An event\"},{\"label\":\"Other\"}],\"id\":18305}]",
"countries": [
{
"id": 233,
"name": "United States",
"iso": "US"
}
],
"form_styles": null,
"form_respondents_count": 2,
"public_token": "Xk3vP9qLm2RtW8yZb5NcJg",
"embed_settings": {
"password_protected": false
},
"embed_url": "https://forms.fluid.app/Xk3vP9qLm2RtW8yZb5NcJg?embed=true",
"share_url": "https://forms.fluid.app/Xk3vP9qLm2RtW8yZb5NcJg"
}
],
"pagination": {
"current_page": 1,
"total_pages": 1,
"total_count": 4,
"per_page": 20
},
"filters": {
"sorted_by": [
[
"Created At (Newest First)",
"created_at_desc"
],
[
"Created At (Oldest First)",
"created_at_asc"
],
[
"Title (A-Z)",
"title_asc"
],
[
"Title (Z-A)",
"title_desc"
]
]
},
"meta": {
"request_id": "5d0c9a7e-2f41-4b8d-9e36-c1a7f0b2d843",
"timestamp": "2026-10-07T15:40:02Z"
}
}