cURL

curl -X GET "https://apiweb.mile.app/api/v3/tasks/export-log?page=1&limit=10&sortBy=requestAt&sortOrder=desc" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "status": true,
  "message": "Success",
  "total": 25,
  "data": [
    {
      "_index": "export",
      "_type": "_doc",
      "_id": "exp_61e5477611c1b26cef05d37c",
      "_score": 1,
      "_source": {
        "organizationId": "61c2fbaaf27b374e8913fe72",
        "dataType": "task",
        "dataName": "Task Export - January 2024",
        "status": "Done",
        "requestAt": "2024-01-15T10:30:00+00:00",
        "completedAt": "2024-01-15T10:32:15+00:00",
        "email": "john.doe@mile.app",
        "fileUrl": "https://staticdev.mile.app/production-mile/20240115/task_61c2fbaaf27b374e8913fe72_1705315800.xlsx",
        "fileType": "xlsx",
        "totalRecords": 1247,
        "errorMessage": null
      }
    },
    {
      "_index": "export",
      "_type": "_doc",
      "_id": "exp_61e5477611c1b26cef05d38d",
      "_score": 1,
      "_source": {
        "organizationId": "61c2fbaaf27b374e8913fe72",
        "dataType": "data",
        "dataName": "Customer Data Export",
        "status": "Processing",
        "requestAt": "2024-01-15T11:00:00+00:00",
        "completedAt": null,
        "email": "john.doe@mile.app",
        "fileUrl": null,
        "fileType": "xlsx",
        "totalRecords": 0,
        "errorMessage": null
      }
    },
    {
      "_index": "export",
      "_type": "_doc",
      "_id": "exp_61e5477611c1b26cef05d39e",
      "_score": 1,
      "_source": {
        "organizationId": "61c2fbaaf27b374e8913fe72",
        "dataType": "vehicle",
        "dataName": "Fleet Report - December 2023",
        "status": "Failed",
        "requestAt": "2024-01-14T09:00:00+00:00",
        "completedAt": "2024-01-14T09:05:30+00:00",
        "email": "john.doe@mile.app",
        "fileUrl": null,
        "fileType": "xlsx",
        "totalRecords": 0,
        "errorMessage": "Query timeout: Dataset too large"
      }
    }
  ],
  "params": {
    "from": 0,
    "size": 10,
    "query": {
      "bool": {
        "must": [
          {
            "term": {
              "organizationId.keyword": "61c2fbaaf27b374e8913fe72"
            }
          },
          {
            "range": {
              "requestAt": {
                "lte": "2024-01-15T12:00:00+00:00",
                "gte": "2023-12-16T12:00:00+00:00"
              }
            }
          }
        ]
      }
    },
    "sort": [
      {
        "requestAt": {
          "order": "desc"
        }
      }
    ]
  }
}

Export Task

Get export log history

Retrieve the history of export operations for the authenticated user’s organization. This endpoint returns a paginated list of all export activities including tasks, data sources, vehicles, drivers, and other exportable entities.

Key Features:

Returns exports from the last 30 days only (older exports are automatically purged)
Filters by user email by default (shows only current user’s exports)
Supports filtering by export status, data type, and data name
Powered by ElasticSearch for fast querying

Export Status Values:

Processing: Export is being generated in the background
Done: Export completed successfully, file is ready for download
Failed: Export failed due to an error

Data Types:

task: Task exports
data: Data source exports
vehicle: Vehicle exports
driver: Driver exports
route: Route exports

Important Notes:

Export files are stored for 30 days, after which they are automatically deleted
Download links are S3 presigned URLs with expiration time
Use this endpoint to monitor background exports initiated via background=true parameter

GET

tasks

export-log

cURL

curl -X GET "https://apiweb.mile.app/api/v3/tasks/export-log?page=1&limit=10&sortBy=requestAt&sortOrder=desc" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "status": true,
  "message": "Success",
  "total": 25,
  "data": [
    {
      "_index": "export",
      "_type": "_doc",
      "_id": "exp_61e5477611c1b26cef05d37c",
      "_score": 1,
      "_source": {
        "organizationId": "61c2fbaaf27b374e8913fe72",
        "dataType": "task",
        "dataName": "Task Export - January 2024",
        "status": "Done",
        "requestAt": "2024-01-15T10:30:00+00:00",
        "completedAt": "2024-01-15T10:32:15+00:00",
        "email": "john.doe@mile.app",
        "fileUrl": "https://staticdev.mile.app/production-mile/20240115/task_61c2fbaaf27b374e8913fe72_1705315800.xlsx",
        "fileType": "xlsx",
        "totalRecords": 1247,
        "errorMessage": null
      }
    },
    {
      "_index": "export",
      "_type": "_doc",
      "_id": "exp_61e5477611c1b26cef05d38d",
      "_score": 1,
      "_source": {
        "organizationId": "61c2fbaaf27b374e8913fe72",
        "dataType": "data",
        "dataName": "Customer Data Export",
        "status": "Processing",
        "requestAt": "2024-01-15T11:00:00+00:00",
        "completedAt": null,
        "email": "john.doe@mile.app",
        "fileUrl": null,
        "fileType": "xlsx",
        "totalRecords": 0,
        "errorMessage": null
      }
    },
    {
      "_index": "export",
      "_type": "_doc",
      "_id": "exp_61e5477611c1b26cef05d39e",
      "_score": 1,
      "_source": {
        "organizationId": "61c2fbaaf27b374e8913fe72",
        "dataType": "vehicle",
        "dataName": "Fleet Report - December 2023",
        "status": "Failed",
        "requestAt": "2024-01-14T09:00:00+00:00",
        "completedAt": "2024-01-14T09:05:30+00:00",
        "email": "john.doe@mile.app",
        "fileUrl": null,
        "fileType": "xlsx",
        "totalRecords": 0,
        "errorMessage": "Query timeout: Dataset too large"
      }
    }
  ],
  "params": {
    "from": 0,
    "size": 10,
    "query": {
      "bool": {
        "must": [
          {
            "term": {
              "organizationId.keyword": "61c2fbaaf27b374e8913fe72"
            }
          },
          {
            "range": {
              "requestAt": {
                "lte": "2024-01-15T12:00:00+00:00",
                "gte": "2023-12-16T12:00:00+00:00"
              }
            }
          }
        ]
      }
    },
    "sort": [
      {
        "requestAt": {
          "order": "desc"
        }
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

Use a valid Bearer token to authenticate.

Query Parameters

sortBy

string

Field name to sort the results by. Sorts the export log entries based on the specified field. Example: requestAt, status, dataType, dataName Default: requestAt

sortOrder

enum<string>

Sort order for the results. Use asc for ascending or desc for descending order. Example: desc Default: desc

Available options:

asc,

desc

limit

integer

Maximum number of export log entries to return per page. Controls pagination size. Example: 20 Default: 10 Min: 1, Max: 100

Required range: 1 <= x <= 100

page

integer

Page number for pagination. Use in combination with limit to navigate through results. Example: 1 Default: 1 Min: 1

Required range: x >= 1

dataName

string

Filter export logs by the name of the exported data. Useful for finding exports of specific entities. Example: Task Export - January 2024, Driver List

dataType

enum<string>

Filter export logs by type of data that was exported. Helps narrow down results to specific export categories. Example: task, data, vehicle

Available options:

task,

data,

vehicle,

driver,

route

status

enum<string>

Filter export logs by processing status. Use to find exports that are still processing, completed, or failed. Example: Done, Processing, Failed

Available options:

Processing,

Done,

Failed

string

Filter export logs by user email who initiated the export. If not provided, defaults to the authenticated user's email. Example: john.doe@mile.app Default: Current user's email

Response

Success - Export log retrieved

status

boolean

Status of response.

message

string

Message of API response.

total

integer

Total number of export log entries matching the filters (across all pages).

data

object[]

Array of export log entries from ElasticSearch.

Show child attributes

data._index

string

ElasticSearch index name

data._type

string

ElasticSearch document type

data._id

string

Unique identifier for the export log entry

data._score

number

ElasticSearch relevance score

data._source

object

Actual export log data

Show child attributes

data._source.organizationId

string

Organization ID that owns this export

data._source.dataType

string

Type of data that was exported (task, data, vehicle, etc.)

data._source.dataName

string

Name or description of the export

data._source.status

string

Current status of the export (Processing, Done, Failed)

data._source.requestAt

string

Timestamp when export was requested (ISO 8601 format)

data._source.completedAt

string

Timestamp when export was completed (ISO 8601 format, null if still processing)

data._source.email

string

Email of user who initiated the export

data._source.fileUrl

string

S3 download URL for the exported file (presigned URL with expiration)

data._source.fileType

string

Format of the exported file (xlsx, json, zip)

data._source.totalRecords

integer

Total number of records exported

data._source.errorMessage

string

Error message if export failed (null if successful)

params

object

ElasticSearch query parameters used for this request (for debugging purposes).

Export Config Export tasks

⌘I

Getting Started

Webhook

Task

Routing

Flow

Data

Setting

Import/Export

File

Objects

Get export log history

Authorizations

Query Parameters

Response