---
title: "Get information about an existing IFTA detail job."
method: GET
path: "/ifta-detail/csv/{id}"
tags: ["IFTA"]
---

# Get information about an existing IFTA detail job.

`GET /ifta-detail/csv/{id}`

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/ifta-detail/csv/{id}`
- Auth: HTTP bearer

Get information about an existing IFTA detail job.

 <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).

To use this endpoint, select **Read IFTA (US)** under the Compliance category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
 

 **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.

## Path parameters

- `id` string, required

## Response `200`

OK response.

- IFTAGetIftaDetailJobResponseBody
  - `data` IftaDetailJobResponseBody, required: A job representing the async generation of IFTA mileage segments. The job should be polled until the state is terminal.
    - `args` IftaDetailJobArgsResponseBody, required: The arguments used to create this job.
      - `endHour` string, required: The `endHour` used to create this job.
      - `startHour` string, required: The `startHour` used to create this job.
      - `vehicleIds` integer[], required: The vehicleIds used to create this job. Determined by the filter list of `vehicleIds`, `vehicleTagIds`, and `vehicleParentTagIds` parameters (if provided).
    - `completedAtTime` string: The time this job completed successfully.
    - `details` string: A message containing additional details about the job, if available.
    - `failedAtTime` string: The time this job failed.
    - `files` IftaDetailJobOutputResponseBody[]: A list of files generated by this job. This field will be omitted when the job status is "Failed" or no data exists with the provided job arguments. Read about the file structure [here](https://developers.samsara.com/docs/ifta-detail-csv).
      - `createdAtTime` string, required: When this file was created.
      - `downloadUrl` string, required: A url to download the generated file. The contents will be gzipped. This url has an expiration and will no longer be valid after expiration.
      - `downloadUrlExpirationTime` string, required: The expiration time of this file's download url. Requesting this job again by ID will refresh the download urls, if expired.
      - `name` string, required: The name of this file.
      - `recordCount` integer, required: The number of records in this file.
    - `jobId` string, required: The ID used to retrieve this job.
    - `jobStatus` 'Requested' | 'Processing' | 'Completed' | 'Failed', required: The status of this job. `jobStatus` can be one of Requested, Processing, Completed, or Failed. Valid values: `Requested`, `Processing`, `Completed`, `Failed`
    - `requestedAtTime` string, required: The time this job was requested for creation.
    - `startedAtTime` string: The time this job started processing.

## Other responses

- `401`: Unauthorized response.
- `404`: Not Found response.
- `405`: Method Not Allowed response.
- `413`: Content Too Large response.
- `429`: Too Many Requests response.
- `500`: Internal Server Error response.
- `501`: Not Implemented response.
- `502`: Bad Gateway response.
- `503`: Service Unavailable response.
- `504`: Gateway Timeout response.
- `default`: Bad Request response.

---

[API](https://skmtc.dev/samsara/apis/samsara-api.md) - [All operations](https://skmtc.dev/samsara/apis/samsara-api/llms.txt) - [OpenAPI document](https://skmtc.dev/samsara/apis/samsara-api/revisions/a9e35d4999be?raw)