Get form fills

Description

The method creates an export task for form fill data.

URL

Method: POST

https://example.com/api/v1.1/forms/fills

Request Parameters

Parameter	Type	Example	Required	Description
token	string	a1b2c3d4e5f67890abcdef1234567890	Yes	API token
id	int	1	Yes, if shortname is not specified	Form ID
shortname	string	form_6Ven2v7O	Yes, if id is not specified	Form short name
date_from	string	2026-04-01	Yes	Start date of the period. Format: YYYY-MM-DD
date_to	string	2026-04-30	Yes	End date of the period. Format: YYYY-MM-DD

Request Example

JSON

{
  "token": "a1b2c3d4e5f67890abcdef1234567890",
  "id": 1,
  "date_from": "2026-04-01",
  "date_to": "2026-04-30"
}

XML

<xml>
  <token>a1b2c3d4e5f67890abcdef1234567890</token>
  <id>1</id>
  <date_from>2026-04-01</date_from>
  <date_to>2026-04-30</date_to>
</xml>

Response Example

JSON

{
  "data": {
    "task_id": "550e8400-e29b-41d4-a716-446655440000"
  },
  "error": 0,
  "error_text": "Successful operation"
}

XML

<xml>
  <data>
    <task_id>550e8400-e29b-41d4-a716-446655440000</task_id>
  </data>
  <error>0</error>
  <error_text>Successful operation</error_text>
</xml>

Response Parameters

Parameter	Type	Description
error	int	Error code
error_text	string	Error text
data	object	Response data object

data Object

Parameter	Type	Description
task_id	string	Async task ID for retrieving fill data