> For the complete documentation index, see [llms.txt](https://docs.udara360.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.udara360.io/udara360-docs-1/limit/card/add-card-limit.md).

# Add Card Limit

To create a limit record for a card, you can send a `POST` request to the following endpoint:

<mark style="color:yellow;">`POST`</mark> `/api/Limit/v{{version}}/AddCardLimit`

The request body should contain the `cardId`, the `cardProvider`, and the full set of limit values across ATM, POS, and online channels, including daily/weekly limits and transaction counts for each.

This endpoint streamlines the process of configuring how a card can be used, offering granular control over spending and withdrawal behavior across every channel it supports.

**Headers**

| Name                                           | Value              |
| ---------------------------------------------- | ------------------ |
| Content-Type<mark style="color:red;">\*</mark> | `application/json` |

**Body**

<table><thead><tr><th>Name</th><th>Data Type</th><th data-type="checkbox">Required</th><th>Description</th></tr></thead><tbody><tr><td><code>atM_Daily_Withdrawal_Limit</code></td><td><em>long</em></td><td>true</td><td>Determines the maximum amount that can be done in a week for the card specified as it relates to ATM transactions.</td></tr><tr><td><code>atM_Single_Withdrawal_Limit</code></td><td><em>long</em></td><td>true</td><td>Determines the amount that can be done in a single transaction for the card specified as it relates to ATM transactions.</td></tr><tr><td><code>atM_Daily_Withdrawal_Count</code></td><td><em>integer</em></td><td>true</td><td>Determines the maximum number of transactions that can be done in a day for the card specified as it relates to ATM transactions.</td></tr><tr><td><code>atM_Weekly_Withdrawal_Limit</code></td><td><em>long</em></td><td>true</td><td>Determines the maximum amount that can be done in a week for the card specified as it relates to ATM transactions.</td></tr><tr><td>poS_Daily_Transaction_Limit</td><td><em>long</em></td><td>true</td><td>Determines the maximum amount that can be done in a day for the card specified as it relates to POS transactions.</td></tr><tr><td><code>poS_Daily_Transaction_Count</code></td><td><em>integer</em></td><td>true</td><td>Determines the maximum number of transactions that can be done in a day for the card specified as it relates to POS transactions.</td></tr><tr><td><code>poS_Daily_Withdrawal_Limit</code></td><td><em>long</em></td><td>true</td><td>Determines the maximum amount that can be withdrawn in a day for the card specified as it relates to POS transactions.<br><br><em>This has to do with POS withdrawal.</em></td></tr><tr><td><code>poS_Weekly_Withdrawal_Limit</code></td><td><em>long</em></td><td>true</td><td>Determines the maximum amount that can be done in a week for the card specified as it relates to POS transactions.</td></tr><tr><td><code>online_Daily_Transaction_Limit</code></td><td><em>long</em></td><td>true</td><td>Determines the maximum amount that can be done in a day for the card specified as it relates to web or online payment.</td></tr><tr><td><code>online_Daily_Transaction_Count</code></td><td><em>integer</em></td><td>true</td><td>Determines the count of transaction that can be done in a day for the card specified as it relates to web or online payment.</td></tr><tr><td><code>cardId</code></td><td><em>string</em></td><td>true</td><td>The ID of the card record.</td></tr><tr><td><code>cardProvider</code></td><td><em>integer</em></td><td>true</td><td>The card processor that hosts the card.<br><br><em>Default (Interswitch) = 0, ARCA = 1, Providus = 2.</em></td></tr></tbody></table>

Here is an example request and response with a sample payload sent to the endpoint in Curl format.

<details>

<summary>Sample Request</summary>

```json
curl --location -g '{{baseUrl}}api/Limit/v{{version}}/AddCardLimit' \
--header 'Content-Type: application/json' \
--data '{
  "atM_Daily_Withdrawal_Limit": 10000,
  "atM_Single_Withdrawal_Limit": 2000,
  "atM_Daily_Withdrawal_Count": 3,
  "atM_Weekly_Withdrawal_Limit": 70000,
  "poS_Daily_Transaction_Limit": 10000,
  "poS_Daily_Transaction_Count": 3,
  "poS_Daily_Withdrawal_Limit": 2000,
  "poS_Weekly_Withdrawal_Limit": 70000,
  "online_Daily_Transaction_Limit": 10000,
  "online_Daily_Transaction_Count": 3,
  "cardId": "5099f14c-b963-4919-95a4-104a42eeedd8",
  "cardProvider": 0 // Default (Interswitch) = 0, ARCA = 1, Providus = 2
}'
```

</details>

<details>

<summary>Response: <code>200</code></summary>

```json
{
  "status": true,
  "message": "Operation Successful"
}
```

</details>