---
title: "Retrieve list of charge key limit caps"
method: GET
path: "/api/v1/charge-key-limit-caps"
tags: ["Charge Key Limit Caps"]
---

# Retrieve list of charge key limit caps

`GET /api/v1/charge-key-limit-caps`

## Request

- Base URL: `https://partner-api.monta.com`
- URL: `https://partner-api.monta.com/api/v1/charge-key-limit-caps`
- Auth: HTTP bearer

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

An operator has one set of caps per team settings profile (Hub: Operator team settings); `defaultForTeamType` says which teams get the set by default. A charge key's own usage limits (`rollingSpendLimit`, `dailyChargeCountLimit`, `concurrentChargesLimit`) may not exceed the caps its team is bound by. A `null` cap is not configured, so the `recommended` value is the cap. Caps may not exceed `max`, Monta's ceiling.

Only operator-scoped consumers may read caps; a team-scoped consumer gets `403`.

## Query parameters

- `operatorId` integer
- `page` integer
- `perPage` integer

## Response `200`

List of charge key limit caps

- OffsetBasedResponse7
  - `data` ChargeKeyLimitCap[], required
    - `id` integer: Id of this set of caps
    - `operatorId` integer: Id of the operator these caps belong to
    - `name` string, nullable: Name of the team settings profile, as shown in the Hub
    - `defaultForTeamType` string, nullable: Teams of this type get these caps by default: `professional`, `private`, `all`, `operator`, `default_private_team`, `none`, or `null` when the caps apply only to teams assigned to the profile explicitly. Also sets which `recommended` and `max` values apply.
    - `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: Cap on a charge key's daily charge count. `null` means no cap is configured, so `recommended` applies.
    - `concurrentChargesLimit` integer, nullable: Cap on a charge key's concurrent charges. `null` means no cap is configured, so `recommended` applies.
    - `recommended` ChargeKeyLimitValues, required
      - `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: Daily charge count limit
      - `concurrentChargesLimit` integer, nullable: Concurrent charges limit
    - `max` ChargeKeyLimitValues, required
      - `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: Daily charge count limit
      - `concurrentChargesLimit` integer, nullable: Concurrent charges limit
  - `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/charge-key-limit-caps/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)