Get All Reports

POST

/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 90 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

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://apiv3.imocha.io/v3/reports?PageNo=1&PageSize=100' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "startDate": "2025-07-31T12:00:56Z",
    "endDate": "2025-10-29T12:34:56Z"
}'

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-11-19 08:57:38

Get Reports By TestId

Process Callbacks