# Get Limits

You will be able to retrieve the remaining transfer limits of a particular user's wallet based on your spec sheet and transactions they have already created. 

The transfer limits are categorized into the following transfer and transaction types:

1. Load: Adding funds into the wallet through linked card or bank.
2. Unload: Withdrawing funds from the wallet to linked card or bank.
3. Internal: Sending funds to another wallet holder.
4. External: Sending funds to external recipients using [transaction API](https://paas.docs.machnetinc.com/api-references/transaction/create-1). This limit can also be obtained using the [Get Transaction limits API](https://paas.docs.machnetinc.com/api-references/transaction/get-transaction-limits) but is only applicable for Clients who are approved for both wallet and external transactions.

The remaining limits are also broken down into the following types:

1. Annual limit: Annual limit minus the amount already transfered this year.
2. Daily limit: Daily limit minus the amount already transfered today.
3. Monthly limit: Monthly limit minus the amount already transfered this month.
4. Wallet hold limit: Maximum wallet hold limit minus the actual balance of the wallet. This is particularly valid for LOAD transfer types as load amount shall not exceed remaining wallet hold limit.

#### **`GET /users/{userId}/limits`**

{% tabs %}
{% tab title="Details" %}

| Field                                | Required | Type    | Description                                                         |
| ------------------------------------ | -------- | ------- | ------------------------------------------------------------------- |
| country                              | Response | String  | 2-letter ISO code of the user’s country                             |
| current\_tier                        | Response | Numeric | Current tier of the user                                            |
| remaining\_limit                     | Response | Object  | Remaining transaction limit of the user in the current tier         |
| remaining\_limit.annual\_limit       | Response | Numeric | Remaining annual transaction limit of the user in the current tier  |
| remaining\_limit.monthly\_limit      | Response | Numeric | Remaining monthly transaction limit of the user in the current tier |
| remaining\_limi.daily\_limit         | Response | Numeric | Remaining daily transaction limit of the user in the current tier   |
| remaining\_limit.wallet\_hold\_limit | Response | Numeric | Remaining amount that can be held in the wallet                     |
| user\_id                             | Response | UUID    | UUID of the user                                                    |
| type                                 | Response | String  | Transaction and transfer type for which the limits are applicable   |
| {% endtab %}                         |          |         |                                                                     |

{% tab title="Request Sample" %}

```
curl --location --request GET '{{url}}/users/{userId}/limits' \
--header 'X-Client-Id:{{client_id}} ' \
--header 'X-Client-Secret: {{client_secret}}' \
--header 'Content-Type: application/json'
```

{% endtab %}

{% tab title="Response Sample" %}

```
[
    {
    "country": "US",
    "remaining_limit": {
        "annual_limit": 10000,
        "daily_limit": 200,
        "monthly_limit": 5000
    },
    "type": "EXTERNAL",
    "current_tier" : 1,
    "user_id": UUID
   },
    {
        "remaining_limit": {
            "annual_limit": 6401.00,
            "daily_limit": 1790.00,
            "monthly_limit": 2310.00,
            "wallet_hold_limit": 2000.00
        },
        "type": "LOAD",
        "current_tier" : 1,
        "user_id": UUID
    },
    {
        "remaining_limit": {
            "annual_limit": 9860.80,
            "daily_limit": 22.00,
            "monthly_limit": 4960.80
        },
        "type": "UNLOAD",
        "current_tier" : 1,
        "user_id": UUID
    },
    {
        "remaining_limit": {
            "annual_limit": 9876.60,
            "daily_limit": 200,
            "monthly_limit": 4906.60
        },
        "type": "TRANSFER",
        "current_tier" : 1,
        "user_id": UUID
    }
]
```

{% endtab %}
{% endtabs %}