Skip to main content

Rejected Tasks Report

Task rejection records with reason, moment, and driver details.

GET/apidev/v1/reports/gt/rejected-tasks
PermissionAPICLI_RPTGT_RECHAZOTAREA
Rate Limit10 req/min
Cache300s
Max Range31 days

Request

Query Parameters

ParameterTypeRequiredDefaultDescription
startdatestringYesISO 8601 start date-time (e.g. 2026-03-01T00:00:00).
enddatestringYesISO 8601 end date-time. Max range 31 days from startdate.
devicesstringNoComma-separated device IDs. Max 500.
driversstringNoComma-separated driver IDs. Max 500.
rejection_momentsstringNoComma-separated moment codes. Max 10. Values: not_accepted, accepted, timeout, nack.
rejection_reason_idsstringNoComma-separated rejection reason IDs. Max 100.
limitintegerNo25Number of records per page (1100).
offsetintegerNo0Number of records to skip for pagination.

Code Examples

curl -s -H "Authorization: Bearer $TOKEN" \
-H "X-API-Key: $APIKEY" \
-H "tenant: $TENANT" \
"https://$TENANT/apidev/v1/reports/gt/rejected-tasks?startdate=2026-03-01T00:00:00&enddate=2026-03-15T23:59:59&limit=25"

Response

Response Fields

FieldTypeDescription
rejection_datestring | nullRejection timestamp.
task_numberstring | nullTask number.
device_namestringVehicle name.
driver_namestringDriver name.
rejection_reasonstringRejection reason text.
not_accepted_messagestringDriver's rejection message.
rejection_momentstringMoment code.
rejection_moment_textstringMoment description.

Example Response

{
"success": true,
"data": [
{
"rejection_date": "2026-03-05T08:22:00",
"task_number": "104820580001",
"device_name": "Truck A-101",
"driver_name": "Carlos Martinez",
"rejection_reason": "Route too far",
"not_accepted_message": "Cannot reach in time",
"rejection_moment": "not_accepted",
"rejection_moment_text": "Not accepted by driver"
}
],
"meta": {
"total": 1,
"limit": 25,
"offset": 0
}
}

Errors

CodeHTTPDescription
BAD_REQUEST400Missing required headers.
VALIDATION_ERROR400Invalid params: missing dates, range > 31 days, invalid enum values.
UNAUTHORIZED401Invalid or expired JWT / API Key.
FORBIDDEN403User lacks required permission.
RATE_LIMITED429Exceeded 10 req/min.
INTERNAL_ERROR500Unexpected server error.