---
agentTools:
  projectIndex: https://partner.getpliant.com/llms.txt
---

# Cardholder status & card limit change callback

We added some minor improvements in the domains of cardholder and card limit endpoints

## Cardholder status

Previously the cardholder status was not exposed. We improved it by:

1. adding the `status` property to **query params** & **response body** of [GET /api/cardholders](https://partner.getpliant.com/reference/getcardholders-1)
2. adding the `status` property to the **response body** of [GET /api/cardholders/\{cardholderId}](https://partner.getpliant.com/reference/getcardholderdetails-1)
3. adding a new callback `CARDHOLDER_INVITED` to [POST /cardholders/subscription](https://partner.getpliant.com/reference/createcardholdersubscription-1) which is triggered when a member is invited.
4. extending the Callback object `cardholderUpdate` with `status` property

Possible ENUMs are:

```
INVITED
ACTIVE
DEACTIVATED
```

## Card limit changes

We do now provide more granular information about card limit changes. So whenever one of the listed properties of a card is updated we trigger the `CARD_LIMIT_CHANGED` callback (if setup via [POST /cards/subscriptions](https://partner.getpliant.com/reference/createcardsubscription-1)).

```
transactionLimit
monthlyLimit (this one is deprecated)
limit
limitRenewFrequency
```

We provide a new property called limitChange which includes the previous and the new values so you can easily build e.g. notifications on top of it. Please find an example below:

```Text json
{
  "eventType": "CARD_LIMIT_CHANGED",
  "cardId": "...",
  "organizationId": "...",
  "cardholderId": "...",
  "type": "VIRTUAL",
  "status": "ACTIVE",
  "label": "Test",
  "limitChange": {
    "beforeChange": {
      "transactionLimit": {
        "value": 4200,
        "currency": "EUR"
      },
      "limit": {
        "value": 4200,
        "currency": "EUR"
      },
      "limitRenewFrequency": "QUARTERLY"
    },
    "afterChange": {
      "transactionLimit": {
        "value": 8400,
        "currency": "EUR"
      },
      "limit": {
        "value": 8400,
        "currency": "EUR"
      },
      "limitRenewFrequency": "QUARTERLY"
    }
  }
```