> 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/7.-kampanya/9.-aktif-kampanyalar.md).

# 9. Aktif Kampanyalar

## Aktif **Kampanya Listele**

<mark style="color:blue;">`GET`</mark>`{{WalletUrl}}/api/v1/campaign/active?pageNumber=1&pageSize=10&currencyCode=try&regionId=1`

{% 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>Genel API erişimi sağlamak için kullanılan doğrulama anahtarıdır.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Evet</td><td>İstemci uygulamayı tanımlayan genel tanıtım anahtarıdır.</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>İşlemin başarısız olup olmadığını belirtir. true ise hata olmuştur.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>İşlemin başarılı olup olmadığını belirtir. true ise başarıyla tamamlanmıştır.</td></tr><tr><td>Errors</td><td>Array</td><td>Oluşan hata/hatalar varsa detaylarını içeren dizi.</td></tr><tr><td>Value</td><td>Array</td><td>Başarılı yanıt durumunda dönen asıl veri içeriğini barındırır.</td></tr><tr><td>Id</td><td>Guid</td><td>Kampanyaya ait benzersiz kimlik numarası.</td></tr><tr><td>Name</td><td>string</td><td>Kampanyanın adı.</td></tr><tr><td>Description</td><td>string</td><td>Kampanya hakkında açıklayıcı bilgi.</td></tr><tr><td>MinimumDepositAmount</td><td>decimal</td><td>Kampanyanın geçerli olması için gereken minimum yatırma tutarı.</td></tr><tr><td>MaximumDepositAmount</td><td>decimal</td><td>Kampanyanın geçerli olacağı maksimum yatırma tutarı.</td></tr><tr><td>BonusType</td><td>string</td><td>Kampanyada tanımlı olan bonus tipi (ör. oran, sabit tutar).</td></tr><tr><td>BonusValue</td><td>decimal</td><td>Verilecek bonusun değeri.</td></tr><tr><td>CampaignType</td><td>string</td><td>Kampanya türü (ör. yeni kullanıcı, genel).</td></tr><tr><td>StartDate</td><td>DateTime</td><td>Kampanyanın başlangıç tarihi.</td></tr><tr><td>EndDate</td><td>DateTime</td><td>Kampanyanın bitiş tarihi.</td></tr><tr><td>IsActive</td><td>bool</td><td>Kampanyanın aktif olup olmadığını ifade eder.</td></tr><tr><td>TotalBonusGiven</td><td>decimal</td><td>Kampanya süresince dağıtılan toplam bonus miktarını gösterir.</td></tr><tr><td>RegionId</td><td>integer</td><td>Kampanyanın geçerli olduğu bölgenin tanımlayıcısı.</td></tr><tr><td>CurrencyCode</td><td>string</td><td>Kampanyanın geçerli olduğu para birimi kodu.</td></tr><tr><td>CreatedAt</td><td>DateTime</td><td>Kaydın sistemde oluşturulduğu tarihtir.</td></tr><tr><td>UpdatedAt</td><td>DateTime</td><td>Kaydın en son güncellendiği zaman bilgisidir.</td></tr></tbody></table>

</details>

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

```json
{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Items": [
            {
                "Id": "01afe72a-a2e5-4383-b370-bf13b49af0b8",
                "Name": "External Campaign 2",
                "Description": "External campaign description 2",
                "MinimumDepositAmount": 1.00,
                "MaximumDepositAmount": 1000.00,
                "BonusType": "Fixed",
                "BonusValue": 1.00,
                "CampaignType": "CashBack",
                "StartDate": "2025-09-01",
                "EndDate": "2025-12-31",
                "IsActive": true,
                "TotalBonusGiven": 0.00,
                "CreatedAt": "2025-08-20T14:50:19.136185Z",
                "UpdatedAt": null
            },
            {
                "Id": "762abb9c-f2a2-4770-a933-11411cfa8964",
                "Name": "External Campaign",
                "Description": "External campaign description",
                "MinimumDepositAmount": 1.00,
                "MaximumDepositAmount": 1000.00,
                "BonusType": "Fixed",
                "BonusValue": 1.00,
                "CampaignType": "Bonus",
                "StartDate": "2025-09-01",
                "EndDate": "2025-12-31",
                "IsActive": true,
                "TotalBonusGiven": 0.00,
                "CreatedAt": "2025-08-20T14:50:02.241666Z",
                "UpdatedAt": null
            }
        ],
        "PageNumber": 1,
        "TotalPages": 1,
        "TotalCount": 2,
        "HasPreviousPage": false,
        "HasNextPage": false
    }
}
```

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