---
title: "List CARB CTC vehicle collection history"
method: GET
path: "/fleet/carb-ctc/vehicles/history"
tags: ["CARB CTC"]
---

# List CARB CTC vehicle collection history

`GET /fleet/carb-ctc/vehicles/history`

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/fleet/carb-ctc/vehicles/history`
- Auth: HTTP bearer

Returns paginated collection history for a batch of vehicles enrolled in the CARB CTC program. Use vehicle IDs from the list enrolled vehicles endpoint. Optionally filter by time range. Results are ordered by happenedAtTime descending, with vehicle ID as a tiebreaker.

 <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 CARB CTC Integration** under the CARB CTC Integration 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.

## Query parameters

- `vehicleIds` string, required
- `startTime` string
- `endTime` string
- `after` string

## Response `200`

OK response.

- CarbCtcListCarbCtcVehicleHistoryResponseBody
  - `data` CarbCtcVehicleHistoryObjectResponseBody[], required: List of collection history entries.
    - `enrollmentId` string, uuid, required: Unique identifier for this CARB CTC enrollment.
    - `enrollmentVin` string, required: Vehicle Identification Number associated with the CARB CTC enrollment.
    - `happenedAtTime` string, date-time, required: When the collection happened, in RFC 3339 format.
    - `id` string, required: Samsara vehicle ID.
    - `testResult` 'pass' | 'fail' | 'error' | 'unknown', required: The outcome of the collection test. Valid values: `pass`, `fail`, `error`, `unknown`
    - `testResultDetails` string: Human-readable context for the test result.
  - `pagination` GoaPaginationResponseResponseBody, required: Pagination parameters.
    - `endCursor` string, required: Cursor identifier representing the last element in the response. This value should be used in conjunction with a subsequent request's 'after' query parameter. This may be an empty string if there are no more pages left to view.
    - `hasNextPage` boolean, required: True if there are more pages of results immediately available after this endCursor.

## 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)