Reports

Survey task report#

Returns information about all the surveys that match specified filters.

POST
/survey/report

Request body:

Attribute	Type	Description	Nullable
makeXls	Boolean	If true, the request returns an Excel file instead of a JSON	true
templateId	String	Survey template ID	true
taskId	Integer	ID of the Task object the surveys are linked to	true
regionIds	List of integers	IDs of Region objects	true
divisionIds	List of integers	IDs of Division objects	true
dateFrom	LocalDate (yyyy-MM-dd)	Creation date from	true
dateTo	LocalDate (yyyy-MM-dd)	Creation date to	true
status	String enum (OPEN, IN_PROGRESS, CLOSED)	Status of the Response the survey is linked to	true
overdue	Boolean	Returns true if the deadline of the task is missed	true
approvalStatus	String enum (APPROVED, NOT_APPROVED, APPROVABLE, NOT_APPROVABLE)	Approval status of the response	true

Response

Returns a Survey task report object

Examples

curl --request POST https://api.qvalon.com/v1/survey/report \
--header 'Authorization: Bearer <your_token>' \
-d '{"makeXls":false,"taskId":900,"regionIds":[92],"divisionIds":[],"dateFrom":"2023-01-01","dateTo":"2023-12-31","status":"CLOSED"}'

200 OK

[
  {
    "instanceId": "9e1261a1-9437-4dc6-bdf3-daec41b21674",
    "executorName": "Catherine White (Store Manager)",
    "authorName": "API",
    "templateName": "Cash Register Survey",
    "taskName": "Monthly cash register survey",
    "divisionName": "United States",
    "regionName": "California",
    "shopName": "9524 Springfield",
    "shopSap": "9524",
    "shopLocality": "9524 Springfield",
    "comment": "",
    "status": "CLOSED",
    "startDate": 1686296680056,
    "closeDate": 1686296820616,
    "deadLineDate": 1688155200000,
    "percentGrade": 0,
    "maxGrade": 0,
    "sumGrade": 0,
    "withGrades": false,
    "questionWithAnswerDTOS": [
      {
        "questionId": "ebdcb5d6-b5df-4c9d-971f-f75fa7d459a8",
        "questionName": "Attach several photos of the cash register",
        "answers": [
          "/files/s1/qvalon/2023/6/9/test_image.jpg",
          "/files/s1/qvalon/2023/6/9/test_image2.jpg"
        ],
        "comment": ""
      }
    ]
  }
]