---
title: "List all gateways"
method: GET
path: "/gateways"
tags: ["Gateways"]
---

# List all gateways

`GET /gateways`

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/gateways`
- Auth: HTTP bearer

List all gateways

 <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 Gateways** under the Setup & Administration 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

- `models` string[]
- `after` string

## Response `200`

OK response.

- GatewaysGetGatewaysResponseBody
  - `data` GatewayResponseObjectResponseBody[], required: Activated gateways
    - `accessoryDevices` AccessoryResponseObjectResponseBody[]: Accessory devices on gateway
      - `model` string: Product model name of the device
      - `serial` string: The serial number of the accessory device.
    - `asset` GatewayAssetResponseObjectResponseBody: An object containing information about the asset the gateway is installed on
      - `externalIds` object: A map of external ids
      - `id` string: The unique Samsara ID of the asset where the gateway is installed. This is automatically generated when the asset is created and cannot be changed. Use this ID on PATCH vehicle, equipment, or trailer endpoints to update the asset
    - `connectionStatus` ConnectionStatusResponseObjectResponseBody: An objecting containing information about the connectivity status of the gateway
      - `healthStatus` 'Status Not Set' | 'Connected' | 'Not Installed' | 'Power Source Off - Active Vehicle' | 'Power Source Off - Inactive Vehicle' | 'Weak Cellular Signal' | 'Requires Investigation' | 'Requires Charge' | 'Unsupported Product' | 'Low Battery. Replace Device.' | 'Low Vehicle Battery' | 'Unplugged' | 'Low Charging State' | 'Vehicle Off' | 'Weak GPS Signal' | 'Low Gateway Battery' | 'Low Gateway Battery (AG24)' | 'Low Gateway Battery (AG45)' | 'Low Gateway Battery (AG26)' | 'Low Gateway Battery (AG46)' | 'Low Gateway Battery (AG46-P)' | 'Temporarily Offline' | 'Prolonged Offline' | 'Recently Offline' | 'Replacement Required' | 'Status Unknown': The most recent health status of the gateway. Valid values: `Status Not Set`, `Connected`, `Not Installed`, `Power Source Off - Active Vehicle`, `Power Source Off - Inactive Vehicle`, `Weak Cellular Signal`, `Requires Investigation`, `Requires Charge`, `Unsupported Product`, `Low Battery. Replace Device.`, `Low Vehicle Battery`, `Unplugged`, `Low Charging State`, `Vehicle Off`, `Weak GPS Signal`, `Low Gateway Battery`, `Low Gateway Battery (AG24)`, `Low Gateway Battery (AG45)`, `Low Gateway Battery (AG26)`, `Low Gateway Battery (AG46)`, `Low Gateway Battery (AG46-P)`, `Temporarily Offline`, `Prolonged Offline`, `Recently Offline`, `Replacement Required`, `Status Unknown`
      - `lastConnected` string: The last time the gateway was connected in RFC 3339 format. Millisecond precision and timezones are supported. (Examples: 2019-06-13T19:08:25Z, 2019-06-13T19:08:25.455Z, OR 2015-09-15T14:00:12-04:00).
    - `dataUsageLast30Days` DataUsageResponseObjectResponseBody: An object containing information about the gateway data usage in mb for the last 30 days.
      - `cellularDataUsageBytes` integer: Celluar data usage in bytes.
      - `hotspotUsageBytes` integer: Wifi hotspot data usage in bytes.
    - `model` 'AG15' | 'AG24' | 'AG24EU' | 'AG26' | 'AG26EU' | 'AG41' | 'AG41EU' | 'AG45' | 'AG45EU' | 'AG46' | 'AG46EU' | 'AG46P' | 'AG46PEU' | 'AG51' | 'AG51EU' | 'AG52' | 'AG52EU' | 'AG53' | 'AG53EU' | 'AT11' | 'AT11X' | 'AT12' | 'AT12X' | 'AT13' | 'IG15' | 'IG21' | 'IG41' | 'IG61' | 'SG1' | 'SG1B' | 'SG1G' | 'SG1G32' | 'SG1x' | 'VG32' | 'VG33' | 'VG34' | 'VG34EU' | 'VG34FN' | 'VG34M' | 'VG54ATT' | 'VG54EU' | 'VG54FN' | 'VG54NA' | 'VG54NAE' | 'VG54NAH' | 'VG55EU' | 'VG55FN' | 'VG55NA', required: The model of the gateway installed on the asset. Valid values: `AG15`, `AG24`, `AG24EU`, `AG26`, `AG26EU`, `AG41`, `AG41EU`, `AG45`, `AG45EU`, `AG46`, `AG46EU`, `AG46P`, `AG46PEU`, `AG51`, `AG51EU`, `AG52`, `AG52EU`, `AG53`, `AG53EU`, `AT11`, `AT11X`, `AT12`, `AT12X`, `AT13`, `IG15`, `IG21`, `IG41`, `IG61`, `SG1`, `SG1B`, `SG1G`, `SG1G32`, `SG1x`, `VG32`, `VG33`, `VG34`, `VG34EU`, `VG34FN`, `VG34M`, `VG54ATT`, `VG54EU`, `VG54FN`, `VG54NA`, `VG54NAE`, `VG54NAH`, `VG55EU`, `VG55FN`, `VG55NA`
    - `serial` string, required: The serial number of the gateway installed on the asset.
  - `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)