Advanced Forms Report

Digital form submissions with dynamic parameters — requires a specific form_id.

GET/apidev/v1/reports/gt/advanced-forms

PermissionAPICLI_RPTGT_FORMAVANZADO

Rate Limit10 req/min

Cache300s

Max Range31 days

---

Overview

Returns digital form submissions for a specific form (form_id is required) over a date range, with the dynamic field values captured in each submission alongside the related client, account, and task. Use columns to select which form parameters to include in the parameters array of each row. Submissions not linked to a task are included with task_number and task_date as null.

---

Request

Request Headers

Every request to a protected endpoint requires these headers:

Header	Required	Description
Authorization	Yes	Bearer token obtained from the Login endpoint. Format: Bearer <token>
X-API-Key	Yes	Company integration key provided during onboarding. Format: gtk_xxx...
tenant	Yes	Your assigned tenant domain (default: geotareas.com) — always send your assigned tenant
Content-Type	Conditional	application/json — required for POST and PUT requests

Query Parameters

Parameter	Type	Required	Default	Description
startdate	string	Yes	—	ISO 8601 start date-time (e.g. 2026-03-01T00:00:00).
enddate	string	Yes	—	ISO 8601 end date-time. Max range 31 days from startdate.
form_id	string	Yes	—	The form to query.
devices	string	No	—	Comma-separated device IDs. Max 500.
drivers	string	No	—	Comma-separated driver IDs. Max 500.
service_types	string	No	—	Comma-separated service type IDs. Max 100.
causes	string	No	—	Comma-separated cause IDs. Max 100.
providers	string	No	—	Comma-separated provider IDs. Max 100.
provider_types	string	No	—	Comma-separated provider type IDs. Max 50.
client_id	string	No	—	Filter by client ID.
account_id	string	No	—	Filter by account ID.
columns	string	No	—	Comma-separated form parameter names to include in parameters. Omit to return all parameters. Max 500 chars.
limit	integer	No	25	Number of records per page (1–100).
offset	integer	No	0	Number of records to skip for pagination.

---

Code Examples

cURL

curl -s -H "Authorization: Bearer $TOKEN" \
  -H "X-API-Key: $APIKEY" \
  -H "tenant: $TENANT" \
  "https://$TENANT/apidev/v1/reports/gt/advanced-forms?startdate=2026-03-01T00:00:00&enddate=2026-03-15T23:59:59&form_id=104820579700&limit=25"

JavaScript

const res = await fetch(
  `https://${TENANT}/apidev/v1/reports/gt/advanced-forms?startdate=2026-03-01T00:00:00&enddate=2026-03-15T23:59:59&form_id=104820579700&limit=25`,
  {
    headers: {
      'Authorization': `Bearer ${TOKEN}`,
      'X-API-Key': APIKEY,
      'tenant': TENANT,
    },
  }
);
const data = await res.json();

Python

import requests

response = requests.get(
    f"https://{TENANT}/apidev/v1/reports/gt/advanced-forms",
    headers={"Authorization": f"Bearer {TOKEN}", "X-API-Key": APIKEY, "tenant": TENANT},
    params={"startdate": "2026-03-01T00:00:00", "enddate": "2026-03-15T23:59:59", "form_id": "104820579700", "limit": 25},
)
data = response.json()

---

Response

Response Fields

Field	Type	Description
form_id	string	Form identifier.
account_id	string | null	Account identifier.
account_name	string	Account name.
client_id	string | null	Client identifier.
client_name	string	Client name.
task_number	string | null	Task number.
task_date	string | null	Task date.
parameters	array	Dynamic form field values.

Parameters Array Fields

Field	Type	Description
tab_id	string | null	Tab identifier.
param_id	string | null	Parameter identifier.
param_name	string	Parameter name.
value_string	string | null	Text value.
value_number	number | null	Numeric value.

Example Response

{
  "success": true,
  "data": [
    {
      "form_id": "104820579700",
      "account_id": "104820579800",
      "account_name": "Client Corp",
      "client_id": "104820579900",
      "client_name": "Client Corp S.A.",
      "task_number": "104820580001",
      "task_date": "2026-03-05",
      "parameters": [
        {
          "tab_id": "1",
          "param_id": "10",
          "param_name": "Condition",
          "value_string": "Good",
          "value_number": null
        },
        {
          "tab_id": "1",
          "param_id": "11",
          "param_name": "Score",
          "value_string": null,
          "value_number": 85
        }
      ]
    }
  ],
  "meta": {
    "total": 1,
    "limit": 25,
    "offset": 0
  }
}

---

Errors

Code	HTTP	Description
VALIDATION_ERROR	400	Invalid params: missing dates, missing form_id, range > 31 days.
UNAUTHORIZED	401	Missing, invalid, or expired tenant / Authorization / X-API-Key
FORBIDDEN	403	User lacks required permission.
RATE_LIMITED	429	Exceeded 10 req/min.
INTERNAL_ERROR	500	Unexpected server error.

---

Related

• Tasks General Report
• Pagination