---
title: "[beta] List Ground Intelligence issues"
method: GET
path: "/ground-intelligence/issues"
tags: ["Beta APIs"]
---

# \[beta\] List Ground Intelligence issues

`GET /ground-intelligence/issues`

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/ground-intelligence/issues`
- Auth: HTTP bearer

Returns a paginated list of Ground Intelligence issues for an organization, ordered by updatedAtTime descending and then id ascending.

 <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 Ground Intelligence Issues** under the Ground Intelligence 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

- `ids` string
- `types` string
- `statuses` string
- `severities` string
- `endTime` string
- `queryByTimeField` string
- `startTime` string
- `after` string
- `limit` integer

## Response `200`

OK response.

- EntityGroundIntelligenceIssuesServiceListIssuesResponseBody
  - `data` EntityListIssuesTypeResponseBody[], required: An array of GroundIntelligenceIssues
    - `createdAtTime` string: Time when this issue record was created.
    - `dashboardUrl` string: URL to view this issue in the Samsara dashboard.
    - `firstSeenTime` string: Time when this issue was first observed.
    - `id` string: Unique identifier for the issue.
    - `lastSeenTime` string: Time when this issue was most recently observed.
    - `location` ListIssuesEntityGroundIntelligenceIssueGroundIntelligenceIssueLocationTypeResponseBody: ListIssuesEntityGroundIntelligenceIssueGroundIntelligenceIssueLocation object
      - `point` ListIssuesEntityGroundIntelligenceIssueLatLngTypeResponseBody: ListIssuesEntityGroundIntelligenceIssueLatLng object
        - `latitude` number, double
        - `longitude` number, double
      - `type` string: Shape of the issue location.
    - `observationCount` integer: Number of evidence records aggregated into this issue.
    - `roadSegment` ListIssuesEntityGroundIntelligenceIssueGroundIntelligenceIssueRoadSegmentTypeResponseBody: ListIssuesEntityGroundIntelligenceIssueGroundIntelligenceIssueRoadSegment object
      - `roadClass` string: Read-only Base Maps Overture road-class slug for the matched road segment (for example, motorway or residential), when available. Sourced from basemapsservice; not writable via update.
      - `roadName` string: Road name associated with this issue, when available.
      - `roadSurface` string: Read-only Base Maps Overture surface slug covering the issue's snapped position (for example, paved or gravel), when available. Sourced from basemapsservice; not writable via update.
    - `severity` string: Customer-facing severity level for this issue.
    - `status` string: Current customer-facing review status of this issue.
    - `type` 'unknown' | 'pothole' | 'roadCracking' | 'patchedPothole' | 'transverseCrack' | 'longitudinalCrack' | 'alligatorCrack' | 'utilityCut' | 'steelPlate' | 'repavingNeeded': Customer-facing type for this issue. Valid values: `unknown`, `pothole`, `roadCracking`, `patchedPothole`, `transverseCrack`, `longitudinalCrack`, `alligatorCrack`, `utilityCut`, `steelPlate`, `repavingNeeded`
    - `updatedAtTime` string: Time when this issue record was most recently updated.
  - `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)