> 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/3.-getir-name.md).

# 3. Getir (Name)

## **İsimle Kayıt Bilgisi Getir**

<mark style="color:green;">`GET`</mark>`{{WalletUrl}}/api/v1/campaign/by/name?name=test&currencyCode=try&regionId=1`&#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>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><tr><td>name</td><td>string</td><td>Evet</td><td>Kampanyanın adı.</td></tr><tr><td>regionId</td><td>int</td><td>Evet</td><td>Kampanyanın geçerli olduğu bölgenin tanımlayıcısı.</td></tr><tr><td>currencyCode</td><td>string</td><td>Evet</td><td>Kampanyanın geçerli olduğu para birimi kodu.</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": [
        {
            "Id": "ffcbf4f3-63ec-4a16-a8c4-e0ec80539788",
            "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,
            "RegionId": 1,
            "CurrencyCode": "TRY",
            "CreatedAt": "2025-08-20T23:24:20.03957Z",
            "UpdatedAt": null
        }
    ]
}
```

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