> For the complete documentation index, see [llms.txt](https://developer.paywall.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.paywall.one/cuzdan-servisleri/5.-limit-kullanimlari/3.-limit-kullanim-merchant.md).

# 3. Limit Kullanım (Merchant)

## **Limit Kullanımını Getir**

<mark style="color:green;">`GET`</mark>`{{WalletUrl}}/api/v1/limit/usage/by/merchant/:id?Category=1&PageNumber=1&PageSize=10`&#x20;

{% hint style="info" %}
Not: Bu servisin kullanılabilmesi için **apikeypublic** ve **apiclientpublic** parametrelerinin Header alanına eklenmiş olması zorunludur.

\
[<mark style="color:green;">**WalletAPI Adresi**</mark>](/ortam.md)
{% endhint %}

**Gerekli header ve istek parametreleri:**

<details>

<summary><strong>Parametreler ve açıklamaları</strong></summary>

<table><thead><tr><th width="162">Parametre</th><th width="79">Tip</th><th width="107">Zorunlu</th><th width="403">Açıklama</th></tr></thead><tbody><tr><td>apikeypublic</td><td>string</td><td>Evet</td><td>API erişiminde doğrulama için kullanılan genel anahtar bilgisidir.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Evet</td><td>İsteğin hangi istemciden geldiğini gösteren genel istemci anahtarıdır.</td></tr><tr><td>Category</td><td>integer</td><td>Hayır</td><td>Limitin kullanım kategorisini bu parametreyle belirtebilirsiniz<br><br>Bkz: <a href="/pages/yhSd8QIt22sQ95LbMAUi">Limit Kategorileri</a></td></tr><tr><td>PageNumber</td><td>integer</td><td>Evet</td><td>Limit kullanımlarının döndüğü liste içerisinde kaçıncı sayfayı almak istediğinizi bu parametreyle belirtebilirsiniz</td></tr><tr><td>PageSize</td><td>integer</td><td>Evet</td><td>Limit kullanımlarının döndüğü liste içerisinde kaç kayıt listelenmesini istediğinizi bu parametreyle belirtebilirsiniz</td></tr></tbody></table>

</details>

**Servisten dönen parametreler şu şekildedir:**

<details>

<summary><strong>Parametreler ve açıklamaları</strong></summary>

<table><thead><tr><th width="234.05859375">Parametre</th><th width="162.38671875">Tip</th><th width="348.94140625">Açıklama</th></tr></thead><tbody><tr><td>IsFailure</td><td>bool</td><td>İşlem başarısızsa true döner.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>İşlem başarılıysa true döner.</td></tr><tr><td>Errors</td><td>Array</td><td>İşlem sırasında oluşan hata listesi.</td></tr><tr><td>HasNextPage</td><td>bool</td><td>Sonraki sayfa mevcutsa true döner.</td></tr><tr><td>TotalCount</td><td>int</td><td>Toplam kayıt sayısını belirtir.</td></tr><tr><td>TotalPages</td><td>int</td><td>Toplam sayfa sayısını belirtir.</td></tr><tr><td>PageNumber</td><td>int</td><td>Bulunulan sayfa numarasını gösterir.</td></tr><tr><td>Items</td><td>Array</td><td>Sayfa içeriğinde dönen veri listesidir.</td></tr><tr><td>Id</td><td>Guid</td><td>Limite ait kimlik bilgisi</td></tr><tr><td>WalletId</td><td>Guid</td><td>Cüzdan kimlik bilgisi</td></tr><tr><td>LimitType</td><td>string</td><td>İlgili limitin tipi<br><br>Bkz: <a href="/pages/8WxqFp9P9sysluulqynj">Limit Tipleri</a></td></tr><tr><td>LimitCategory</td><td>string</td><td>İlgili limitin kategorisi<br><br>Bkz: <a href="/pages/yhSd8QIt22sQ95LbMAUi">Limit Kategorisi</a></td></tr><tr><td>LimitApproach</td><td>string</td><td>İlgili limitin kontrol tipi<br><br>Bkz: <a href="/pages/Oe73wenQngio9pAM24ik">Limit Kontrol Tipleri</a></td></tr><tr><td>UsedValue</td><td>decimal</td><td>Kullanılan limit değeri</td></tr><tr><td>LimitValue</td><td>decimal</td><td>Limit değeri</td></tr><tr><td>RemainingValue</td><td>decimal</td><td>Mevcut periyotta kullanılabilecek kalan limit değeri. <code>LimitValue</code> ile <code>UsedValue</code> arasındaki farktır. <code>LimitApproach</code> = <code>Amount</code> ise kalan tutar, <code>Count</code> ise kalan işlem adedini ifade eder.</td></tr><tr><td>PeriodStart</td><td>DateTime</td><td>Limitin tanımlandığı periyot kapsamında başlangıç tarihi<br><br><mark style="color:blue;">Not: Bu tarih, periyot bittikten sonra tekrar yenilenir</mark></td></tr><tr><td>PeriodEnd</td><td>DateTime</td><td>Limitin tanımlandığı periyot kapsamında bitiş tarihi</td></tr><tr><td>IsActive</td><td>bool</td><td>Aktiflik durumu</td></tr><tr><td>CreatedAt</td><td>DateTime</td><td>Kaydın oluşturulma tarihi</td></tr><tr><td>UpdatedAt</td><td>DateTime</td><td>Kaydın güncellenme tarihi</td></tr><tr><td>ExternalTransactionTypeId</td><td>guid</td><td>Kendi sisteminizdeki işlem tipinin UUID tanımlayıcısı. <code>LimitCategory</code> = <code>ExternalTransactionType</code> olduğunda kullanılır</td></tr><tr><td>CurrencyCode</td><td>string</td><td>Limitin uygulandığı para birimi kodu</td></tr></tbody></table>

</details>

{% tabs %}
{% tab title="JSON" %}
{% code lineNumbers="true" %}

```json
{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Items": [
            {
                "Id": "30c84d1c-0a0f-48e1-9cfa-f1a5cb80e0a1",
                "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
                "LimitType": 1,
                "LimitCategory": 1,
                "LimitApproach": 1,
                "UsedValue": 100.00,
                "LimitValue": 1000.00,
                "RemainingValue": 900.00,
                "PeriodStart": "2025-08-20T00:00:00Z",
                "PeriodEnd": "2025-08-20T23:59:59.999999Z",
                "IsActive": true,
                "CreatedAt": "2025-08-20T10:09:37.007Z",
                "UpdatedAt": "2025-08-20T11:56:17.206Z",
                "ExternalTransactionTypeId": null,
                "CurrencyCode": "TRY"
            }
        ],
        "PageNumber": 1,
        "TotalPages": 1,
        "TotalCount": 1,
        "HasPreviousPage": false,
        "HasNextPage": false
    }
}
```

{% endcode %}
{% endtab %}
{% endtabs %}