Operator Lists

Retrieve the items of an operator list

Changed on

Retrieves a paginated list of items of a single entity type within an operator list. Required scope: operator-lists:read </br>Organization authorization: supported

get/api/v1/operator-lists/{listId}/items

Request

  • Base URL
    https://partner-api.monta.com
  • URL
    https://partner-api.monta.com/api/v1/operator-lists/{listId}/items
  • Auth
    HTTP bearer

Path parameters

listIdinteger required

Query parameters

entity_type'user' | 'team' | 'charge_point' | 'charge_points_public' | 'site' | 'charge_key' | 'vehicle' required

The entity type of the items to retrieve.

searchstring

Free-text search filter by item label. Max 255 characters.

pageinteger

Page number to retrieve (starts with 0)

perPageinteger

Number of items per page (between 1 and 100, default 10)

Response

Paginated items of the operator list

Example response

{
  "data": [
    {
      "id": 1,
      "entityType": "user",
      "entityId": 20,
      "label": "Jane Doe",
      "addedAt": "2024-03-16T15:37:23Z"
    }
  ]
}

Changes