Task Types
This article covers Task types
Task now have a new field called type associated with it. Type allows more functionality and flexibility such as End Route at. When creating Task, type will supersede pickupTask and will throw an error if the fields do not match up. The following Table explains what each field represents:
| Value | Description |
|---|---|
| 0 | Pickup Task. This represents pickupTask is true. |
| 1 | Dropoff Task. This represents pickupTask is false |
| 2 | End at Hub Task. This represents an End at Hub Task, will require the associated Team/Hub to have a validate address Object. |
| 3 | End at Driver's Address Task. This represents an End at Driver Task, will require the associated Drivers to have a validate address Object attached. |
| 4 | This is read only value. This requires Route Load feature and is represents the Route Load Tasks. For additional details, please see Onfleet Support Article on this topic. |
End at TasksIn the sidebar and map view, the ‘End at Last Task’/ Driver’s Location is not an actual task in the database. Instead these are virtual tasks only displayed in the sidebar and map as informational indicators to Dispatchers/ Monitors. The task is not recorded in the database nor displayed to drivers.
Examples for different types:
Please note that pickupTask is true and type is 0 from the response:
{
"id": "FHtZtBtReQWsG1mZXvq9lqe3",
"timeCreated": 1744069739000,
"timeLastModified": 1744069739290,
"organization": "nYrkNP6jZMSKgBwG9qG7ci3J",
"shortId": "d37b1822",
"orderShortId": null,
"trackingURL": "https://onf.lt/d37b1822",
"worker": "ZxcnkJi~79nonYaMTQ960Mg2",
"merchant": "nYrkNP6jZMSKgBwG9qG7ci3J",
"executor": "nYrkNP6jZMSKgBwG9qG7ci3J",
"creator": "vjw*RDMKDljKVDve1Vtcplgu",
"dependencies": [],
"state": 1,
"completeAfter": null,
"completeBefore": null,
"pickupTask": true,
"type": 0,
"notes": "",
"completionDetails": {
"failureNotes": "",
"successNotes": "",
"failureReason": "NONE",
"events": [],
"actions": [],
"time": null,
"signatureUploadId": null,
"photoUploadId": null,
"photoUploadIds": null,
"firstLocation": [],
"lastLocation": [],
"unavailableAttachments": []
},
"feedback": [],
"metadata": [],
"overrides": {},
"quantity": 0,
"additionalQuantities": {
"quantityA": 0,
"quantityB": 0,
"quantityC": 0
},
"serviceTime": 0,
"identity": {
"failedScanCount": 0,
"checksum": null
},
"appearance": {
"triangleColor": null
},
"scanOnlyRequiredBarcodes": false,
"customFields": [],
"container": {
"type": "WORKER",
"worker": "ZxcnkJi~79nonYaMTQ960Mg2"
},
"trackingViewed": false,
"recipients": [],
"destination": {
"id": "Fyl~dhVI57~oUgG~ntxR7FiV",
"timeCreated": 1744069739000,
"timeLastModified": 1744069739226,
"location": [
-117.1570422,
32.7075941
],
"address": {
"number": "100",
"street": "Park Boulevard",
"city": "San Diego",
"state": "California",
"postalCode": "92101",
"country": "United States",
"apartment": ""
},
"notes": "",
"metadata": [],
"googlePlaceId": "ChIJ7fMsvKtU2YARXM4yStBv8rU",
"warnings": [
"MISMATCH_NUMBER"
],
"useGPS": false
}
} {
"id": "R2Q2tjbjwL*O7AGo~l02Qsuj",
"timeCreated": 1777902078000,
"timeLastModified": 1777905258849,
"organization": "gz6~YVrx7HVI34ecvWOG1LfB",
"shortId": "a8305ab3",
"orderShortId": null,
"trackingURL": "https://onf.lt/a8305ab3",
"worker": "mQpa~QD~LYcG89bPdig8sREj",
"merchant": "gz6~YVrx7HVI34ecvWOG1LfB",
"executor": "gz6~YVrx7HVI34ecvWOG1LfB",
"creator": "r9UlWdZWMW1PiEyW7QboYSsf",
"dependencies": [],
"state": 1,
"completeAfter": 1777910400000,
"completeBefore": 1777917600000,
"pickupTask": false,
"type": 1,
"notes": "",
"completionDetails": {
"failureNotes": "",
"successNotes": "",
"failureReason": "NONE",
"events": [],
"actions": [],
"time": null,
"signatureUploadId": null,
"photoUploadId": null,
"photoUploadIds": null,
"firstLocation": [],
"lastLocation": [],
"unavailableAttachments": []
},
"feedback": [],
"metadata": [],
"overrides": {},
"quantity": 0,
"additionalQuantities": {
"quantityA": 0,
"quantityB": 0,
"quantityC": 0
},
"serviceTime": 0,
"priority": null,
"group": null,
"barcodes": {
"required": [],
"captured": []
},
"identity": {
"failedScanCount": 0,
"checksum": null
},
"appearance": {
"triangleColor": null
},
"scanOnlyRequiredBarcodes": false,
"routePlan": "MeUkUOk~YVH~BSGLnph~dZLq",
"customFieldGroup": null,
"customRequirements": [],
"customFields": [],
"bulkTasks": [],
"requirements": {
"signature": false,
"notes": false,
"photo": false,
"minimumAge": 0
},
"container": {
"type": "WORKER",
"worker": "mQpa~QD~LYcG89bPdig8sREj"
},
"trackingViewed": false,
"packages": [
{
"organization": "gz6~YVrx7HVI34ecvWOG1LfB",
"pickupTask": "ThlZjOg63YktPlMosR6bm*UD",
"dropoffTask": "R2Q2tjbjwL*O7AGo~l02Qsuj",
"barcode": null,
"pickupCompletionStatus": "loaded",
"createdAt": "2026-05-04T13:58:21.817Z",
"updatedAt": "2026-05-05T01:23:54.416Z",
"capturedBarcode": {
"symbology": "manual",
"data": "",
"location": [
-80.50116188099267,
43.45049376072777
],
"time": "2026-05-05T01:23:32.147Z",
"deviceId": "72CE843A-4267-4415-A860-1C593839F472",
"platform": "ios",
"wasRequested": false,
"id": "QxXyhPFlR1nIgvz4EgMlebOx"
},
"id": "IZ1hr9~zWhDeJSb1WP4YbDOk"
}
],
"recipients": [],
"eta": null,
"delayTime": 869608.553,
"estimatedCompletionTime": 1778787208553,
"estimatedArrivalTime": 1778787041553,
"destination": {
"id": "pA2SSLFAQWu1EHT*hvTssgtE",
"timeCreated": 1777902078000,
"timeLastModified": 1777903006912,
"location": [
-80.4853115,
43.4482913
],
"address": {
"name": "New City Supermarket",
"number": "236",
"street": "King Street East",
"city": "Kitchener",
"state": "Ontario",
"postalCode": "N2G 2L1",
"country": "Canada",
"apartment": ""
},
"notes": "",
"metadata": [],
"googlePlaceId": "ChIJFxnzSuz0K4gR7axbKiLBrc8",
"warnings": [],
"useGPS": false
}
}{
"id": "dyZbhf4dpbFatJ9n4vxrVnYZ",
"timeCreated": 1778171391000,
"timeLastModified": 1778171392082,
"organization": "gz6~YVrx7HVI34ecvWOG1LfB",
"shortId": "483a4eaa",
"orderShortId": null,
"trackingURL": "https://onf.lt/483a4eaa",
"worker": null,
"merchant": "gz6~YVrx7HVI34ecvWOG1LfB",
"executor": "gz6~YVrx7HVI34ecvWOG1LfB",
"creator": "r9UlWdZWMW1PiEyW7QboYSsf",
"dependencies": [],
"state": 0,
"completeAfter": 1778171383000,
"completeBefore": null,
"pickupTask": false,
"type": 2,
"notes": "",
"completionDetails": {
"failureNotes": "",
"successNotes": "",
"failureReason": "NONE",
"events": [],
"actions": [],
"time": null,
"signatureUploadId": null,
"photoUploadId": null,
"photoUploadIds": null,
"firstLocation": [],
"lastLocation": [],
"unavailableAttachments": []
},
"feedback": [],
"metadata": [],
"overrides": {},
"quantity": 0,
"additionalQuantities": {
"quantityA": 0,
"quantityB": 0,
"quantityC": 0
},
"serviceTime": 0,
"priority": null,
"group": null,
"identity": {
"failedScanCount": 0,
"checksum": null
},
"appearance": {
"triangleColor": null
},
"scanOnlyRequiredBarcodes": false,
"routePlan": "gleT4gzfAS3rxmpqoexBe0z6",
"customFieldGroup": null,
"customRequirements": [],
"customFields": [],
"bulkTasks": [],
"requirements": {
"signature": null,
"notes": null,
"photo": null,
"minimumAge": null
},
"container": {
"type": "TEAM",
"team": "9PVeSqj*RxI46~aD*M812DkY"
},
"trackingViewed": false,
"packages": [],
"delayTime": null,
"estimatedCompletionTime": null,
"estimatedArrivalTime": null,
"eta": null,
"recipients": [],
"destination": {
"id": "SZ0gJ1nR9kDM1quuEfHhWaWM",
"timeCreated": 1778171391000,
"timeLastModified": 1778171391873,
"location": [
-80.4960112,
43.4519341
],
"address": {
"name": "Downtown Kitchener Hub",
"number": "365",
"street": "King Street West",
"apartment": "1",
"city": "Kitchener",
"state": "Ontario",
"postalCode": "N2G",
"country": "Canada"
},
"notes": "",
"metadata": [],
"googlePlaceId": null,
"warnings": [],
"useGPS": true
}
}{
"id": "Rkj3WFVTizAcZhn~RqDHBbUw",
"timeCreated": 1777905628000,
"timeLastModified": 1777905628966,
"organization": "gz6~YVrx7HVI34ecvWOG1LfB",
"shortId": "c0ac6fdc",
"orderShortId": null,
"trackingURL": "https://onf.lt/c0ac6fdc",
"worker": null,
"merchant": "gz6~YVrx7HVI34ecvWOG1LfB",
"executor": "gz6~YVrx7HVI34ecvWOG1LfB",
"creator": "r9UlWdZWMW1PiEyW7QboYSsf",
"dependencies": [],
"state": 0,
"completeAfter": 1777906800000,
"completeBefore": null,
"pickupTask": false,
"type": 4,
"notes": "",
"completionDetails": {
"failureNotes": "",
"successNotes": "",
"failureReason": "NONE",
"events": [],
"actions": [],
"time": null,
"signatureUploadId": null,
"photoUploadId": null,
"photoUploadIds": null,
"firstLocation": [],
"lastLocation": [],
"unavailableAttachments": []
},
"feedback": [],
"metadata": [],
"overrides": {},
"quantity": 0,
"additionalQuantities": {
"quantityA": 0,
"quantityB": 0,
"quantityC": 0
},
"serviceTime": 10,
"priority": null,
"group": null,
"barcodes": {
"required": [
{
"id": "V424AIPxPaPYAwf4XcxYDtXR",
"noBarcode": true,
"blockCompletion": false,
"dropoffTask": "2EDvpZYpn0Qfg*TIJ~pue1TL",
"pickupCompletionStatus": "pending"
},
{
"id": "*4DXAeH0TqIZYQQ70IrPc~mh",
"noBarcode": true,
"blockCompletion": false,
"dropoffTask": "iCrVppBCuqpxQioBAb7vloMz",
"pickupCompletionStatus": "pending"
}
],
"captured": []
},
"identity": {
"failedScanCount": 0,
"checksum": null
},
"appearance": {
"triangleColor": null
},
"scanOnlyRequiredBarcodes": true,
"routePlan": "*EOBT5v0Ly64CgHXQPPX4O~g",
"customFieldGroup": null,
"customRequirements": [],
"customFields": [],
"bulkTasks": [],
"requirements": {
"signature": null,
"notes": null,
"photo": null,
"minimumAge": null
},
"container": {
"type": "ORGANIZATION",
"organization": "gz6~YVrx7HVI34ecvWOG1LfB"
},
"trackingViewed": false,
"packages": [
{
"organization": "gz6~YVrx7HVI34ecvWOG1LfB",
"dropoffTask": "2EDvpZYpn0Qfg*TIJ~pue1TL",
"barcode": null,
"pickupCompletionStatus": "pending",
"createdAt": "2026-05-04T14:34:18.540Z",
"updatedAt": "2026-05-04T14:40:28.848Z",
"pickupTask": "Rkj3WFVTizAcZhn~RqDHBbUw",
"id": "V424AIPxPaPYAwf4XcxYDtXR"
},
{
"organization": "gz6~YVrx7HVI34ecvWOG1LfB",
"pickupTask": "Rkj3WFVTizAcZhn~RqDHBbUw",
"dropoffTask": "iCrVppBCuqpxQioBAb7vloMz",
"barcode": null,
"pickupCompletionStatus": "pending",
"createdAt": "2026-05-04T14:40:28.848Z",
"updatedAt": "2026-05-04T14:40:28.848Z",
"id": "*4DXAeH0TqIZYQQ70IrPc~mh"
}
],
"delayTime": null,
"estimatedCompletionTime": null,
"estimatedArrivalTime": null,
"eta": null,
"recipients": [],
"destination": {
"id": "r1ifTY*PdJRSQ2tbZcHtGJOS",
"timeCreated": 1777905628000,
"timeLastModified": 1777905628542,
"location": [
-80.4960112,
43.4519341
],
"address": {
"name": "Downtown Kitchener Hub",
"number": "365",
"street": "King Street West",
"apartment": "1",
"city": "Kitchener",
"state": "Ontario",
"postalCode": "N2G",
"country": "Canada"
},
"notes": "",
"metadata": [],
"googlePlaceId": null,
"warnings": [],
"useGPS": true
}
}