# MileIQ

> Read your MileIQ profile, drives, teams and reported mileage.

App · 6 actions. Web page: https://docs.lodol.com/docs/integrations/mileiq

## Actions

### Get Current User Profile

Get your MileIQ profile, including personal details, contact information and account status.

**Inputs**: None.

**Outputs**: Value.

- `data` (object): Complete user profile information including identity, contact details, and account status
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value, or empty at the end.

**Example output**

```json
{
  "data": {
    "active": false,
    "displayName": "example",
    "emails": [
      {
        "primary": false,
        "type": "example",
        "value": "example"
      }
    ],
    "id": "example",
    "name": {
      "familyName": "example",
      "formatted": "example",
      "givenName": "example"
    },
    "userName": "example"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get Group by ID

Get a team by its ID. You must be an administrator of the team.

**Inputs**

- Group (`group_id`, number, required): Group id.

**Outputs**: Value.

- `data` (object): Response model containing a collection of groups with their complete information and member details
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value, or empty at the end.

**Example output**

```json
{
  "data": {
    "resources": [
      {
        "display_name": "example",
        "id": "example",
        "members": [
          {
            "display": "example",
            "is_admin": false,
            "is_driver": false,
            "value": "example"
          }
        ],
        "meta": {
          "created": "2026-10-01T12:00:00Z",
          "lastModified": "2026-10-01T12:00:00Z",
          "location": "example",
          "resourceType": "example"
        }
      }
    ]
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get Group Reported Drives

List the drives a team's members have reported for review, most recently changed first, with driver and review details. You can filter by date range. A drive's created time is when it was reported; its start and end times are when it happened.

**Inputs**

- Group (`group_id`, text, required): Group id.
- Limit (`limit`, number): The number of drives to retrieve. From 1 to 1000.
- Date before (`date_before`, date and time): The end date of the range to retrieve drives for based on the defined filter_by param (exclusive). Filter_by needs to be set for this field to be used. Should be in UTC
- Date after (`date_after`, date and time): The start date of the range to retrieve drives for based on the defined filter_by param (exclusive). Filter_by needs to be set for this field to be used. Should be in UTC
- Filter by (`filter_by`, text): Use 'ended' to filter by the date the drive has ended. Use 'modified' to filter by the date the drive was last updated. One of: `modified`, `ended`.

**Outputs**: Value.

- `data` (object): The API response.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value, or empty at the end.

**Example output**

```json
{
  "data": {
    "has_more": false,
    "results": [
      {
        "created": "2026-10-01T12:00:00Z",
        "details": {
          "classification": {},
          "description": "example",
          "distance": {},
          "end": {},
          "entry": "manual",
          "parking_fees": {},
          "purpose": "example",
          "start": {},
          "toll_fees": {},
          "value": {}
        },
        "driver": {
          "email": "example",
          "id": "example",
          "name": "example",
          "status": "example",
          "timezone_offset": 1
        },
        "id": "example",
        "modified": "2026-10-01T12:00:00Z",
        "review_comments": [
          {
            "created_at": "2026-10-01T12:00:00Z",
            "id": "example",
            "text": "example",
            "user_email": "example"
          }
        ],
        "status": "example"
      }
    ]
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get Groups

List the teams you are an administrator of.

**Inputs**: None.

**Outputs**: Value.

- `data` (object): Response model containing a collection of groups with their complete information and member details
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value, or empty at the end.

**Example output**

```json
{
  "data": {
    "resources": [
      {
        "display_name": "example",
        "id": "example",
        "members": [
          {
            "display": "example",
            "is_admin": false,
            "is_driver": false,
            "value": "example"
          }
        ],
        "meta": {
          "created": "2026-10-01T12:00:00Z",
          "lastModified": "2026-10-01T12:00:00Z",
          "location": "example",
          "resourceType": "example"
        }
      }
    ]
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get User by ID

Get a user's profile by their ID. You can only see your own profile.

**Inputs**

- Person (`person_id`, text, required): Your MileIQ user. Select your connected profile or enter its ID.

**Outputs**: Value.

- `data` (object): Complete user profile information including identity, contact details, and account status
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value, or empty at the end.

**Example output**

```json
{
  "data": {
    "active": false,
    "displayName": "example",
    "emails": [
      {
        "primary": false,
        "type": "example",
        "value": "example"
      }
    ],
    "id": "example",
    "name": {
      "familyName": "example",
      "formatted": "example",
      "givenName": "example"
    },
    "userName": "example"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get User Drives

List a user's drives, most recently changed first, with locations, distance, value and other details. You can filter by business or personal drives and by date range, and you can only see your own drives. A drive's created time is when it was recorded; its start and end times are when it happened.

**Inputs**

- Person (`person_id`, text, required): Your MileIQ user. Select your connected profile or enter its ID.
- Classification (`classification`, text): Drive classification. One of: `business`, `personal`, `all`.
- Limit (`limit`, number): The number of drives to retrieve. From 1 to 1000.
- Date before (`date_before`, date and time): The end date of the range to retrieve drives for based on the defined filter_by param (exclusive). Filter_by needs to be set for this field to be used. Should be in UTC
- Date after (`date_after`, date and time): The start date of the range to retrieve drives for based on the defined filter_by param (exclusive). Filter_by needs to be set for this field to be used. Should be in UTC
- Filter by (`filter_by`, text): Use 'ended' to filter by the date the drive has ended. Use 'modified' to filter by the date the drive was last updated. One of: `modified`, `ended`.

**Outputs**: Value.

- `data` (object): The API response.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value, or empty at the end.

**Example output**

```json
{
  "data": {
    "has_more": false,
    "results": [
      {
        "classification": "business",
        "created": "2026-10-01T12:00:00Z",
        "description": "example",
        "distance": {
          "amount": 1,
          "units": "mi"
        },
        "drive_id": 1,
        "end": {
          "address": {},
          "lat": "example",
          "lon": "example",
          "name": "example",
          "time": "2026-10-01T12:00:00Z"
        },
        "ended_at": "2026-10-01T12:00:00Z",
        "entry": "manual",
        "modified": "2026-10-01T12:00:00Z",
        "parking_fees": {
          "amount": 1,
          "currency": "USD"
        },
        "purpose": "example",
        "start": {
          "address": {},
          "lat": "example",
          "lon": "example",
          "name": "example",
          "time": "2026-10-01T12:00:00Z"
        },
        "started_at": "2026-10-01T12:00:00Z",
        "toll_fees": {
          "amount": 1,
          "currency": "USD"
        },
        "value": {
          "amount": 1,
          "currency": "USD"
        }
      }
    ]
  },
  "has_more": false,
  "next_cursor": null
}
```
