---
title: "Get IFTA Summary"
method: GET
path: "/ifta/summary"
tags: ["IFTA"]
---

# Get IFTA Summary

`GET /ifta/summary`

Get all vehicle IFTA reports for the requested time span.

Currently can only increment by full months. 

_Note:_ data may change for a few days after the month. We will continue to update those reports to ensure you get accurate results.

## Query parameters

- `cursor` string, cursor
- `expand` 'vehicle'
- `raw` boolean
- `startMonth` string, required — [ISO 8601](https://www.w3.org/TR/NOTE-datetime) month
- `endMonth` string, required — [ISO 8601](https://www.w3.org/TR/NOTE-datetime) month
- `groupBy` 'jurisdiction' | 'vehicle' | 'vehicle,jurisdiction' | 'vehicle,jurisdiction,month'

## Headers

- `X-Application-Id` string
- `Connection-Token` string, required

## Response `200`

OK

- object
  - `results` object[], required
    - `provider` string, required — Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers).
    - `vehicle` union — Entities in Terminal are expandable. Using the `expand` query parameter you can choose to ingest just an ID or the full entity details.
      - string, ulid — Unique identifier for the vehicle in Terminal.
      - object
        - `id` string, ulid, required — Unique identifier for the vehicle in Terminal.
    - `jurisdiction` 'AL' | 'AK' | 'AS' | 'AZ' | 'AR' | 'CA' | 'CO' | 'CT' | 'DE' | 'FL' | 'GA' | 'GU' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MI' | 'MN' | 'MP' | 'MS' | 'MO' | 'MT' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'OH' | 'OK' | 'OR' | 'PA' | 'PR' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VT' | 'VA' | 'WA' | 'WV' | 'WI' | 'WY' | 'VI' | 'AB' | 'BC' | 'MB' | 'NB' | 'NL' | 'NS' | 'ON' | 'PE' | 'QC' | 'SK' | 'NT' | 'NU' | 'UM' | 'YT' | 'DC', nullable — US State or Canadian Province
    - `distance` number, required — Distance in kilometers
    - `month` string — [ISO 8601](https://www.w3.org/TR/NOTE-datetime) month
    - `raw` object[]
      - `provider` string, required
      - `schema` string, required
      - `extractedAt` string, required
      - `data` object, required
  - `next` string, cursor — Cursor used for pagination.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too Many Requests
- `500` — Internal Server Error
- `504` — Gateway Timeout Error

---

[API](https://skmtc.dev/withterminal/apis/terminal-telematics-api.md) · [All operations](https://skmtc.dev/withterminal/apis/terminal-telematics-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withterminal/terminal-telematics-api/revisions/90249c4a1739/schema)