---
updatedAt: 2026-04-21T09:29:18.000Z
agentTools:
  projectIndex: https://partner.getpliant.com/llms.txt
---

# Create Card Limit Request

> 🔒 **Required scope:** `cards:write`
>
> The API credential calling this endpoint must be granted the `cards` category with `read & write` access.
> Scopes are assigned to the credential when it is created or edited in Pliant, not requested when obtaining the access token.
> A credential without this scope receives `403 Forbidden` with the error code `INSUFFICIENT_PERMISSION`.

Create a card limit request for a specific card.


# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "contact": {
      "name": "API Support",
      "email": "support@getpliant.com",
      "url": "https://www.getpliant.com"
    },
    "title": "Pliant Partner API",
    "description": "Pliant Partner API",
    "version": "2.1.0",
    "license": {
      "name": "MIT",
      "url": "https://opensource.org/license/MIT"
    }
  },
  "servers": [
    {
      "url": "https://partner-api.getpliant.com/api",
      "description": "Pliant Production Server"
    },
    {
      "url": "https://sandbox.partner-api.getpliant.com/api",
      "description": "Pliant Sandbox Server"
    },
    {
      "url": "https://pci-api.getpliant.com",
      "description": "PCI Vault Production Server"
    },
    {
      "url": "https://pci-sandbox.partner-api.getpliant.com",
      "description": "PCI Vault Sandbox Server"
    }
  ],
  "x-readme": {
    "explorer-enabled": false,
    "samples-languages": [
      "curl",
      "java",
      "kotlin"
    ],
    "headers": [
      {
        "key": "Pliant-API-Version",
        "value": "2.1.0"
      }
    ]
  },
  "tags": [
    {
      "name": "Cards",
      "description": "This tag is for operations related to cards"
    },
    {
      "name": "Card Limit Requests",
      "description": "This tag is for operations related to card limit requests"
    }
  ],
  "paths": {
    "/cards/limits/{cardId}": {
      "put": {
        "summary": "Update Card Limit",
        "description": "> 🔒 **Required scope:** `cards:write`\n>\n> The API credential calling this endpoint must be granted the `cards` category with `read & write` access.\n> Scopes are assigned to the credential when it is created or edited in Pliant, not requested when obtaining the access token.\n> A credential without this scope receives `403 Forbidden` with the error code `INSUFFICIENT_PERMISSION`.\n\nChange the card limit for a given virtual or physical card, as long as the card is not terminated. This is unrelated to the renew frequency of the card.\nMeaning you can update the limit of a card with a `TOTAL` renew frequency (equals no limit renewal) as well as a `MONTHLY` renew frequency etc.\n\n**Additional limits:** Use the `additionalLimits` field to create, update, or remove additional limits on the card in the same request.\n- Entries **with** an `id` → update the matching existing additional limit.\n- Entries **without** an `id` → create a new additional limit.\n- Existing additional limits **omitted** from the array → soft-delete (removed).\n- Passing `null` or omitting `additionalLimits` → leave existing additional limits unchanged.\n- Passing an **empty array `[]`** → remove all additional limits from the card.\n\n**Response:** This endpoint returns `204 No Content`. To read the updated limit state use `GET /api/cards/{cardId}` or subscribe to the `CARD_LIMITS_CHANGED` callback.\n",
        "x-required-scopes": [
          "cards:write"
        ],
        "tags": [
          "Cards"
        ],
        "operationId": "update-card-limit",
        "parameters": [
          {
            "name": "cardId",
            "in": "path",
            "description": "The ID of the card to update the limit for.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "type": "object",
                    "required": [
                      "limit",
                      "transactionLimit"
                    ],
                    "properties": {
                      "limit": {
                        "type": "object",
                        "description": "The limit of the card. The limit renews according to the `limitRenewFrequency` or never, if `limitRenewFrequency` is set to `TOTAL`.",
                        "properties": {
                          "value": {
                            "type": "number",
                            "description": "The value of the monetary amount, converted to minor units of the currency. For instance 1.00 EUR is 100 cents, thus the value here is `100`. See our [guides](/docs/monetary-values) for more details about how to handle monetary amounts."
                          },
                          "currency": {
                            "type": "string",
                            "description": "The currency of the monetary amount in ISO 4217 format, for example `EUR` for Euro or `USD` for US Dollar. This has to match the currency of the respective [card account](/docs/card-account)!"
                          }
                        }
                      },
                      "limitRenewFrequency": {
                        "type": "string",
                        "enum": [
                          "DAILY",
                          "WEEKLY",
                          "MONTHLY",
                          "QUARTERLY",
                          "ANNUAL",
                          "TOTAL"
                        ],
                        "description": "The frequency of the card limit renewal.\n* `DAILY` - The card limit is renewed every day\n* `WEEKLY` - The card limit is renewed every week\n* `MONTHLY` - The card limit is renewed every calendar month, this is the default setting.\n* `QUARTERLY` - The card limit is renewed every calendar quarter.\n* `ANNUAL` - The card limit is renewed every year.\n* `TOTAL` - The card limit is never going to be renewed. After the limit is spent the card cannot be used anymore.\n"
                      },
                      "transactionLimit": {
                        "type": "object",
                        "description": "The transaction limit of the card. Meaning the maximum amount of a single transaction. This is always below or equal to the `limit` of the card.",
                        "properties": {
                          "value": {
                            "type": "number",
                            "description": "The value of the monetary amount, converted to minor units of the currency. For instance 1.00 EUR is 100 cents, thus the value here is `100`. See our [guides](/docs/monetary-values) for more details about how to handle monetary amounts."
                          },
                          "currency": {
                            "type": "string",
                            "description": "The currency of the monetary amount in ISO 4217 format, for example `EUR` for Euro or `USD` for US Dollar. This has to match the currency of the respective [card account](/docs/card-account)!"
                          }
                        }
                      },
                      "maxTransactionCount": {
                        "type": "number",
                        "minimum": 1,
                        "maximum": 999999999,
                        "description": "Optional field to describe the maximum number of transactions within the range of `1..999999999` that can be performed with this card.\nIf not provided, the card can be used for an unlimited number of transactions until the card expires.\n"
                      },
                      "monthlyLimit": {
                        "type": "object",
                        "deprecated": true,
                        "properties": {
                          "value": {
                            "type": "number",
                            "description": "The value of the monetary amount, converted to minor units of the currency. For instance 1.00 EUR is 100 cents, thus the value here is `100`. See our [guides](/docs/monetary-values) for more details about how to handle monetary amounts."
                          },
                          "currency": {
                            "type": "string",
                            "description": "The currency of the monetary amount in ISO 4217 format, for example `EUR` for Euro or `USD` for US Dollar. This has to match the currency of the respective [card account](/docs/card-account)!"
                          }
                        }
                      }
                    }
                  },
                  {
                    "type": "object",
                    "properties": {
                      "additionalLimits": {
                        "type": "array",
                        "nullable": true,
                        "description": "Additional limits to create, update, or remove. See endpoint description for update semantics.",
                        "items": {
                          "type": "object",
                          "description": "An additional limit to set on a card.\n\n**Update semantics (applies to `PUT /api/cards/limits/{cardId}`):**\n- Entries **with** an `id` → update the matching existing additional limit.\n- Entries **without** an `id` → create a new additional limit.\n- Existing additional limits **omitted** from the array → soft-delete (removed from the card).\n- Passing `null` or omitting `additionalLimits` entirely → leave existing additional limits unchanged.\n- Passing an **empty array `[]`** → remove all additional limits from the card.\n\nThe `id` field is only meaningful for `PUT /api/cards/limits/{cardId}` and `POST /api/cards/limits/requests`. It is ignored in all other contexts.\n",
                          "properties": {
                            "id": {
                              "type": "string",
                              "format": "uuid",
                              "nullable": true,
                              "description": "Identifies an existing additional limit to update. Omit or set to null to create a new limit. Only meaningful for `PUT /api/cards/limits/{cardId}` and `POST /api/cards/limits/requests`."
                            },
                            "limitRenewFrequency": {
                              "type": "string",
                              "enum": [
                                "PER_TRANSACTION",
                                "DAILY",
                                "WEEKLY",
                                "MONTHLY",
                                "QUARTERLY",
                                "ANNUAL",
                                "TOTAL"
                              ],
                              "description": "The renewal frequency for this additional limit. `PER_TRANSACTION` is only valid for additional limits, not for the card's primary limit.\n* `PER_TRANSACTION` - Limit applies to each individual transaction.\n* `DAILY` - The limit is renewed every day.\n* `WEEKLY` - The limit is renewed every week.\n* `MONTHLY` - The limit is renewed every calendar month.\n* `QUARTERLY` - The limit is renewed every calendar quarter.\n* `ANNUAL` - The limit is renewed every year.\n* `TOTAL` - The limit is never renewed. Once spent, no further transactions are allowed under this limit.\n"
                            },
                            "limit": {
                              "type": "object",
                              "description": "The monetary cap for this additional limit. For unscoped limits and limits with `categories`, `acceptanceMethods`, or `atmWithdrawal` scope, the currency must match the card account currency. For currency-scoped limits (`scope.currency` is set), the currency must match `scope.currency`.",
                              "properties": {
                                "value": {
                                  "type": "number",
                                  "description": "The value of the monetary amount, converted to minor units of the currency. For instance 1.00 EUR is 100 cents, thus the value here is `100`. See our [guides](/docs/monetary-values) for more details about how to handle monetary amounts."
                                },
                                "currency": {
                                  "type": "string",
                                  "description": "The currency of the monetary amount in ISO 4217 format, for example `EUR` for Euro or `USD` for US Dollar."
                                }
                              }
                            },
                            "maxTransactionCount": {
                              "type": "number",
                              "nullable": true,
                              "minimum": 1,
                              "maximum": 999999999,
                              "description": "Max number of transactions per renewal period (`1..999999999`). Null means no cap."
                            },
                            "scope": {
                              "type": "object",
                              "nullable": true,
                              "description": "Restricts when this limit applies. Null for a general (unscoped) limit. At least one of `categories`, `acceptanceMethods`, `atmWithdrawal: true`, or `currency` must be set for a scoped limit.",
                              "properties": {
                                "categories": {
                                  "type": "array",
                                  "nullable": true,
                                  "description": "Merchant category types this limit applies to.",
                                  "items": {
                                    "type": "string",
                                    "enum": [
                                      "ADVERTISING_AND_MARKETING",
                                      "COMPUTING_AND_SOFTWARE",
                                      "EDUCATION_AND_TRAINING",
                                      "ELECTRONICS_AND_IT_EQUIPMENT",
                                      "ENTERTAINMENT_AND_WELLNESS",
                                      "FOOD_AND_DRINKS",
                                      "GIFTS_AND_VOUCHERS",
                                      "HEALTHCARE",
                                      "MATERIALS_AND_PACKAGING",
                                      "OFFICE_SUPPLIES_AND_EQUIPMENT",
                                      "SERVICES",
                                      "TRAVEL_AND_ACCOMMODATION",
                                      "OTHER"
                                    ]
                                  }
                                },
                                "acceptanceMethods": {
                                  "type": "array",
                                  "nullable": true,
                                  "description": "The card acceptance methods this limit applies to.",
                                  "items": {
                                    "type": "string",
                                    "enum": [
                                      "ONLINE",
                                      "MOBILE_WALLET",
                                      "MANUAL_ENTRY",
                                      "CONTACTLESS",
                                      "CHIP_DIP",
                                      "NOT_AVAILABLE",
                                      "MAGNETIC_STRIPE",
                                      "OTHER"
                                    ]
                                  }
                                },
                                "atmWithdrawal": {
                                  "type": "boolean",
                                  "nullable": true,
                                  "description": "When `true`, this additional limit applies to ATM withdrawal transactions."
                                },
                                "currency": {
                                  "type": "string",
                                  "nullable": true,
                                  "description": "ISO 4217 currency code this limit applies to, e.g. `PLN` or `USD`. When set, the limit tracks spending in that currency only and is independent of the card's billing currency.\nConstraints:\n* Must differ from the card account's billing currency.\n* The `limit` amount currency must equal this value.\n"
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "Ok"
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "500": {
            "$ref": "#/components/responses/500"
          }
        }
      }
    },
    "/cards/limits/requests": {
      "post": {
        "summary": "Create Card Limit Request",
        "description": "> 🔒 **Required scope:** `cards:write`\n>\n> The API credential calling this endpoint must be granted the `cards` category with `read & write` access.\n> Scopes are assigned to the credential when it is created or edited in Pliant, not requested when obtaining the access token.\n> A credential without this scope receives `403 Forbidden` with the error code `INSUFFICIENT_PERMISSION`.\n\nCreate a card limit request for a specific card.\n",
        "x-required-scopes": [
          "cards:write"
        ],
        "tags": [
          "Card Limit Requests"
        ],
        "operationId": "create-card-limit-requests",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "type": "object",
                    "required": [
                      "cardId"
                    ],
                    "properties": {
                      "organizationId": {
                        "type": "string",
                        "format": "uuid"
                      },
                      "cardholderId": {
                        "type": "string",
                        "format": "uuid"
                      },
                      "cardId": {
                        "type": "string",
                        "format": "uuid"
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": [
                      "limit",
                      "limitRenewFrequency",
                      "transactionLimit",
                      "comment"
                    ],
                    "properties": {
                      "limit": {
                        "type": "object",
                        "properties": {
                          "value": {
                            "type": "number",
                            "description": "The value of the monetary amount, converted to minor units of the currency. For instance 1.00 EUR is 100 cents, thus the value here is `100`. See our [guides](/docs/monetary-values) for more details about how to handle monetary amounts."
                          },
                          "currency": {
                            "type": "string",
                            "description": "The currency of the monetary amount in ISO 4217 format, for example `EUR` for Euro or `USD` for US Dollar."
                          }
                        }
                      },
                      "limitRenewFrequency": {
                        "type": "string",
                        "enum": [
                          "DAILY",
                          "WEEKLY",
                          "MONTHLY",
                          "QUARTERLY",
                          "ANNUAL",
                          "TOTAL"
                        ],
                        "description": "* `DAILY` - The card limit is renewed every day\n* `WEEKLY` - The card limit is renewed every week\n* `MONTHLY` - The card limit is renewed every calendar month\n* `QUARTERLY` - The card limit is renewed every calendar quarter\n* `ANNUAL` - The card limit is renewed every year\n* `TOTAL` - The card limit is never going to be renewed. After the limit is spent the card cannot be used anymore.\n"
                      },
                      "transactionLimit": {
                        "type": "object",
                        "properties": {
                          "value": {
                            "type": "number",
                            "description": "The value of the monetary amount, converted to minor units of the currency. For instance 1.00 EUR is 100 cents, thus the value here is `100`. See our [guides](/docs/monetary-values) for more details about how to handle monetary amounts."
                          },
                          "currency": {
                            "type": "string",
                            "description": "The currency of the monetary amount in ISO 4217 format, for example `EUR` for Euro or `USD` for US Dollar."
                          }
                        }
                      },
                      "comment": {
                        "type": "string",
                        "minLength": 0,
                        "maxLength": 200
                      },
                      "additionalLimits": {
                        "type": "array",
                        "nullable": true,
                        "description": "Optional additional limits being requested. Represents the desired state, not a diff.",
                        "items": {
                          "$ref": "#/paths/~1cards~1limits~1{cardId}/put/requestBody/content/application~1json/schema/allOf/1/properties/additionalLimits/items"
                        }
                      }
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Ok",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "cardLimitRequestId": {
                      "type": "string",
                      "format": "uuid"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "500": {
            "$ref": "#/components/responses/500"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "This API uses oAuth2 with client credentials flow to [obtain the Bearer Token](/docs/authenticated-api-usage).",
        "bearerFormat": "JWT"
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "properties": {
          "errorCode": {
            "type": "string",
            "description": "The error code"
          },
          "exceptionId": {
            "type": "string",
            "format": "uuid",
            "description": "The id of the exception that was thrown"
          },
          "message": {
            "type": "string",
            "description": "The cause of the error or further explanations on the error"
          }
        }
      }
    },
    "responses": {
      "400": {
        "description": "Bad Request. The API consumer sent a malformed request which could not be processed.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "401": {
        "description": "Unauthorized. The API consumer is not authorized to access the requested resource.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "403": {
        "description": "Forbidden. The API consumer is not allowed to access the requested resource.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "404": {
        "description": "Not Found. The requested resource could not be found.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "500": {
        "description": "Internal Server Error. The request was not completed due to an internal error.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ]
}
```