Get All Reports

GET

/v3/reports

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

By default, if no date range is specified, the API returns data from the past 7 days.

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

Request

Query Params

Header Params

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

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' \
--header 'x-api-key;'

Response Example

{
    "reports": [
        {
            "candidateFullName": "string",
            "status": "string",
            "appearedOn": "string",
            "testInvitationId": 0,
            "testId": 0,
            "candidateEmail": "string",
            "completedOn": "string",
            "score": 0,
            "candidatePoints": 0,
            "totalTestPoints": 0,
            "scorePercentage": 0,
            "timeTaken": 0,
            "testDuration": 0,
            "performanceCategory": "string",
            "testName": "string",
            "pdfReportUrl": "string"
        }
    ],
    "pageNumber": 0,
    "totalPages": 0,
    "totalCount": 0,
    "hasPreviousPage": true,
    "hasNextPage": true
}

Modified at 2025-12-30 15:21:38

Get Reports By TestId

Process Callbacks