---
title: "Retrieve a list of reports for charge point(s)."
method: GET
path: "/api/v1/reports"
tags: ["Reports"]
---

# Retrieve a list of reports for charge point(s).

`GET /api/v1/reports`

Required scope: `reports:read`

## Query parameters

- `page` integer
- `perPage` integer
- `chargePointId` integer, nullable — Filter to retrieve reports with specified `chargePointId`
- `state` 'new' | 'action' | 'assigned-owner' | 'assigned-monta' | 'assigned-operator' | 'resolved', nullable — Filter to retrieve reports by `state`
- `fromDate` string, date-time, nullable — Filter to retrieve reports where `createdAt` >= `fromDate` (ISO8601: yyyy-MM-ddTHH:mm:ssZ)
- `toDate` string, date-time, nullable — Filter to retrieve reports where `createdAt` <= `toDate` (ISO8601: yyyy-MM-ddTHH:mm:ssZ)
- `priority` 'low' | 'medium' | 'high', nullable — Priority of the report
- `reasonIdentifier` string, nullable — Filter to retrieve reports with specified reason identifier

## Response `200`

List of reports that match the criteria

- OffsetBasedResponse37
  - `data` ReportDto[], required
    - `id` integer, required — Id of the report
    - `reportedByUserId` integer, nullable — Id of the user who reported
    - `operatorId` integer, required — Id of the operator related to the report
    - `relationType` string, required — Type of the relation
    - `relationId` integer, required — Id of the relation
    - `body` string, nullable — Body of the report
    - `state` string, required — State of the report
    - `reason` ReasonDto
      - `id` integer, required — Id of the reason
      - `identifier` string, required — Identifier of the reason
      - `reason` string, required — Reason of the report
      - `type` string, required — Type of the report
      - `priority` string, required — Priority of the report
    - `source` string, nullable — Source of the report
    - `imageUrls` string[], required — List of image URLs
    - `assignedToOperatorId` integer, nullable — Id of the operator assigned to the report
    - `assignedToUserId` integer, nullable — Id of the user assigned to the report
    - `resolvedByUserId` integer, nullable — Id of the user who resolved the report
    - `operatorNote` string, nullable — Note from the operator
    - `adminNote` string, nullable — Note from the admin
    - `userNote` string, nullable — Note from the user
    - `resolvedAt` string, date-time, nullable — Time when the report was resolved
    - `escalatedAt` string, date-time, nullable — Time when the report was escalated
    - `assignedAt` string, date-time, nullable — Time when the report was assigned
    - `payload` object[], nullable — Additional **raw** payload data, ie. for driver-support reports coming from Zendesk
    - `createdAt` string, date-time, required — Time when the report was created
    - `updatedAt` string, date-time, nullable — Time when the report was updated
    - `deletedAt` string, date-time, nullable — Time when the report was deleted
  - `meta` MontaPageMeta, required
    - `itemCount` integer, required
    - `currentPage` integer, required
    - `perPage` integer, required
    - `totalPageCount` integer, required
    - `totalItemCount` integer, required

## Other responses

- `400` — The request is invalid
- `401` — Consumer with provided credentials was not found
- `403` — Operator doesn't have access to resource
- `404` — Entity with the provided id was not found

---

[API](https://skmtc.net/monta/apis/monta-partner-api.md) · [All operations](https://skmtc.net/monta/apis/monta-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monta/monta-partner-api/versions/517e18f11015/schema)