---
title: "Retrieve a list of operator lists"
method: GET
path: "/api/v1/operator-lists"
tags: ["Operator Lists"]
---

# Retrieve a list of operator lists

`GET /api/v1/operator-lists`

## Request

- Base URL: `https://partner-api.monta.com`
- URL: `https://partner-api.monta.com/api/v1/operator-lists`
- Auth: HTTP bearer

Retrieves a paginated list of the operator's lists. Required scope: `operator-lists:read` </br>Organization authorization: `supported`

## Query parameters

- `search` string
- `list_types` 'user' | 'team' | 'charge_point' | 'charge_points_public' | 'site' | 'charge_key' | 'vehicle'
- `page` integer
- `perPage` integer

## Response `200`

List of operator lists that match the criteria

- OffsetBasedResponse35
  - `data` OperatorList[], required
    - `id` integer, required: Id of the operator list.
    - `operatorId` integer, required: Id of the operator that owns this list.
    - `name` string, required: Name of the operator list.
    - `description` string, nullable: Free-text description of the operator list.
    - `source` string, required: Origin of the list. `partner` for lists created via the Monta API.
    - `listType` 'user' | 'team' | 'charge_point' | 'charge_points_public' | 'site' | 'charge_key' | 'vehicle', nullable: The single entity type a homogeneous list is restricted to. `null` for mixed lists that can hold multiple entity types.
    - `itemCount` integer, required: Total number of items in the list.
    - `itemCounts` object, required: Per-entity-type breakdown of the item count, keyed by entity type.
    - `createdByUserId` integer, nullable: Id of the user who created the list, when known.
    - `createdAt` string, nullable: When the list was created (ISO-8601).
    - `updatedAt` string, nullable: When the list was last updated (ISO-8601).
    - `syncMode` 'MANUAL' | 'AUTO', nullable: Reconciliation mode of a FILTER list; `null` for a manually-curated list.
    - `filterDefinition` object, nullable: The saved filter a FILTER-source list resolves its membership from; `null` for a manual list.
    - `lastSyncedAt` string, nullable: When the list was last reconciled (ISO-8601); `null` if it never has been.
    - `lastSyncStatus` 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED', nullable: Status of the last reconciliation.
    - `pendingSyncRun` OperatorListSyncRun
      - `id` integer, required: Id of the sync run.
      - `listId` integer, required: Id of the list this run reconciled.
      - `status` 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED', required: Status of the run.
      - `trigger` 'MANUAL' | 'AUTO' | 'CREATED' | 'UPDATED', required: What triggered the run.
      - `matchedCount` integer, nullable: How many entities the filter matched. Null until the run finishes.
      - `addedCount` integer, nullable: How many members were added. Null until the run finishes.
      - `removedCount` integer, nullable: How many members were removed. Null until the run finishes.
      - `proposedCount` integer, nullable: How many changes were proposed. Null until the run finishes.
      - `excludedSkippedCount` integer, nullable: How many candidates were skipped because they are excluded. Null until the run finishes.
      - `errorMessage` string, nullable: Error message when the run failed.
      - `startedAt` string, nullable: When the run started (ISO-8601).
      - `finishedAt` string, nullable: When the run finished (ISO-8601).
      - `createdAt` string, nullable: When the run was created (ISO-8601).
      - `updatedAt` string, nullable: When the run was last updated (ISO-8601).
      - `entityIdsByOutcome` object, nullable: The charge-point ids behind each outcome tally, keyed by outcome. Only returned by the single-run endpoint.
  - `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

## Changes

- **2026-11-03** `0ca400461c52`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/monta/apis/monta-partner-api/changes/api/v1/operator-lists/get.md)

---

[API](https://skmtc.dev/monta/apis/monta-partner-api.md) - [All operations](https://skmtc.dev/monta/apis/monta-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monta/apis/monta-partner-api/revisions/0ca400461c52?raw)