Skip to main content
GET
/
v1
/
groups
/
{group_id}
/
reported-drives
Get Group Reported Drives
curl --request GET \
  --url https://api.mileiq.com/v1/groups/{group_id}/reported-drives
{
  "results": [
    {
      "id": "<string>",
      "driver": {
        "id": "<string>",
        "name": "<string>",
        "email": "<string>",
        "status": "<string>",
        "timezone_offset": 123
      },
      "details": {
        "distance": {
          "amount": 123,
          "units": "mi"
        },
        "value": {
          "amount": 123,
          "currency": "USD"
        },
        "toll_fees": {
          "amount": 123,
          "currency": "USD"
        },
        "parking_fees": {
          "amount": 123,
          "currency": "USD"
        },
        "description": "<string>",
        "entry": "manual",
        "classification": "business",
        "purpose": "<string>",
        "start": {
          "name": "<string>",
          "lat": "<string>",
          "lon": "<string>",
          "time": "2023-11-07T05:31:56Z",
          "address": {
            "country": "<string>",
            "state": "<string>",
            "city": "<string>",
            "street": "<string>",
            "postal_code": "<string>"
          }
        },
        "end": {
          "name": "<string>",
          "lat": "<string>",
          "lon": "<string>",
          "time": "2023-11-07T05:31:56Z",
          "address": {
            "country": "<string>",
            "state": "<string>",
            "city": "<string>",
            "street": "<string>",
            "postal_code": "<string>"
          }
        }
      },
      "created": "2023-11-07T05:31:56Z",
      "modified": "2023-11-07T05:31:56Z",
      "status": "<string>",
      "review_comments": [
        {
          "id": "<string>",
          "text": "<string>",
          "created_at": "2023-11-07T05:31:56Z",
          "user_email": "<string>"
        }
      ]
    }
  ],
  "has_more": true
}

Headers

​
Authorization
string

Path Parameters

​
group_id
string
required

Query Parameters

​
limit
integer
default:100

The number of drives to retrieve

Required range: 0 < x <= 1000
​
date_before
string<date-time> | null

The end date of the range to retrieve drives for based on the defined filter_by param. Filter_by needs to be set for this field to be used. Should be in UTC

​
date_after
string<date-time> | null

The start date of the range to retrieve drives for based on the defined filter_by param. Filter_by needs to be set for this field to be used. Should be in UTC

​
filter_by
enum<string> | null

Use 'ended' to filter by the date the drive has ended. Use 'modified' to filter by the date the drive was last updated

Available options:
modified,
ended
​
modified_before
string<date-time> | null

The end date of the range to retrieve drives for. If the drive was reviewed by an admin, this will be the last review date. If not, this will be the same as the date it was reported. [DEPRECATED] Use [date_before, date_after] + filter_by instead

​
modified_after
string<date-time> | null

The start date of the range to retrieve drives for. If the drive was reviewed by an admin, this will be the last review date. If not, this will be the same as the date it was reported. [DEPRECATED] Use [date_before, date_after] + filter_by instead

Response

Successfully retrieved group reported drives. Returns paginated list of drives with complete details including driver info, locations, expenses, and review comments.

​
results
ReportedDriveSchema · object[]
required

Array of reported drive objects containing complete drive details, driver information, and review status for group reporting

​
has_more
boolean
required

Pagination indicator - true if additional drives exist beyond the current result set within the specified filters and date range