---
title: "Search charge auth tokens with cursor-based pagination."
method: GET
path: "/api/v1/charge-auth-tokens/search"
tags: ["Charge Auth Tokens"]
---

# Search charge auth tokens with cursor-based pagination.

`GET /api/v1/charge-auth-tokens/search`

## Request

- Base URL: `https://partner-api.monta.com`
- URL: `https://partner-api.monta.com/api/v1/charge-auth-tokens/search`
- Auth: HTTP bearer

Required scope: `charge-auth-tokens:read` </br>Organization authorization: `supported`

Use this endpoint for high-volume fleets where offset pagination is prohibitive. Filters are intersected with the caller's operator and team scope; ids outside the consumer's scope are rejected with `403`.

## Query parameters

- `operatorIds` string
- `teamIds` string
- `userIds` string
- `search` string
- `blocked` boolean
- `includeSubOperators` boolean
- `size` integer
- `sort` string
- `after` string
- `before` string

## Response `200`

Cursor-paginated list of charge auth tokens matching the criteria

- CursorBasedResponse3
  - `data` ChargeAuthToken[], required
    - `id` integer: The id of the charge auth token
    - `identifier` string, required: The identifier of the charge auth token, Note: without prefix e.g `VID:`
    - `type` 'vehicleId' | 'rfid', required: The method type used for this charge auth token
    - `teamId` integer: Id of the team that the charge auth token belongs to
    - `userId` integer, nullable: Id of the user that the charge auth token is associated to
    - `vehicleId` integer, nullable: Id of the vehicle linked to this charge auth token
    - `partnerExternalId` string, nullable: External Id of this entity, managed by you.
    - `partnerCustomPayload` object, nullable: Custom JSON payload for this entity, managed by you.</br>*Note*: the expected shape is a flat JSON object with named keys.
    - `name` string, nullable: Name of the charge auth token
    - `operator` Operator
      - `id` integer: ID of the operator
      - `name` string, required: Name of operator
      - `identifier` string, required: Identifier of operator
      - `partnerId` integer, nullable: Id of the partner
      - `vatNumber` string, nullable: VAT number
    - `montaNetwork` boolean: If the charge auth token is active in the Monta network
    - `roamingNetwork` boolean: If the charge auth token is active in the Roaming network
    - `operatorNetwork` boolean: Allow this charge auth token to be used on other teams charge points under the same operator
    - `activeUntil` string, date-time, nullable: Indicates until when this charge auth token is active, null means indefinitely
    - `blockedAt` string, date-time, nullable: If the charge auth token is blocked, it will not be able to charge. * `null` = not blocked * date-time = blocked since date-time
    - `createdAt` string, date-time, required: Creation date of this charge auth token
    - `updatedAt` string, date-time, required: Update date of this charge auth token
    - `deleted` boolean: If the charge auth token is deleted
    - `rollingSpendLimit` Money
      - `amount` integer, required: The amount of money
      - `currency` Currency1, required
        - `id` integer, nullable: id of the currency
        - `master` boolean: Whether the currency is master or not, master meaning the default currency
        - `identifier` string, required: 3 characters identifier
        - `name` string: Name of the currency
        - `decimals` integer, required: How many decimals the currency has
      - `locale` string, required: Current user locale
    - `dailyChargeCountLimit` integer, nullable: Maximum number of charges this charge auth token may start in a rolling 24-hour window. `null` means no limit is set.
    - `concurrentChargesLimit` integer, nullable: Maximum number of concurrent active charges this charge auth token may have. `null` means no limit is set.
  - `meta` CursorBasedPageMeta, required
    - `itemCount` integer, nullable: The number of items in the result
    - `perPage` integer: The requested maximum number of items returned
    - `after` string, nullable: A cursor to retrieve the next page of items in a new request
    - `before` string, nullable: A cursor to retrieve the previous page of items in a new request

## 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 breaking, 3 info
  - the `data/items/partnerCustomPayload` response's property type changed from `array` to `object` for status `200`
  - added the optional property `data/items/concurrentChargesLimit` to the response with the `200` status
  - added the optional property `data/items/dailyChargeCountLimit` to the response with the `200` status
  - added the optional property `data/items/rollingSpendLimit` to the response with the `200` status

[Operation history](https://skmtc.dev/monta/apis/monta-partner-api/changes/api/v1/charge-auth-tokens/search/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)