Get All Reports

This API retrieves a paginated list of candidate test reports for a customer between a specifieddate range. It includes test performance, scores, completion status, and PDF report URLs for each candidate.

StartDate (optional, DateTime)
The start of the date range for the report, in UTC. Use ISO 8601 format, for example 2026-10-01T00:00:00Z. If you leave it out, it defaults to 7 days before the current date.

EndDate (optional, DateTime)
The end of the date range for the report, in UTC. Use ISO 8601 format, for example 2026-10-07T23:59:59Z. If you leave it out, it defaults to the current date and time.
The date range between StartDate and EndDate must not exceed 7 calendar days. If the range exceeds 7 days, the API returns 400 Bad Request with the message:

By default, the API returns up to 100 records per request. Additional records can be retrieved using pagination parameters.

curl --location 'https://apiv3.imocha.io/v3/reports?PageNo=1&PageSize=100&includeSections=true&startDate=2015-07-31T12%3A00%3A56Z&endDate=2025-07-31T12%3A00%3A56Z&employeeid=undefined&testid=undefined' \ --header 'x-api-key;'

{ "reports": [ { "testInvitationId": 10000001, "candidateEmail": "[email protected]", "employeeExternalID": "EMP10001", "candidateFullName": "John Doe", "testId": 2000001, "testName": "Sample Database Assessment", "completedOn": "2026-10-07T11:30:00.000", "appearedOn": "2026-10-07T10:45:00.000", "invitedByEmailId": "[email protected]", "pdfReportUrl": "https://example.com/PDFReport?id=dummy-report-id", "performanceCategory": "Competent", "scorePercentage": 75.0, "score": 15.0, "candidatePoints": 15.0, "status": "Complete", "testDuration": 60, "timeTaken": 45, "timeViolation": 0, "totalQuestions": 20, "totalTestPoints": 20.0, "windowViolation": 0, "sections": [] } ], "pageNumber": 1, "totalPages": 10, "totalCount": 100, "hasPreviousPage": false, "hasNextPage": true }

Get All Reports

Request

Responses