# 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 %}

**Servise gönderilmesi gereken parametreler şu şekildedir:**

<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>

{% tabs %}
{% tab title="Servis Cevap - 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 %}

## Servis Cevap

<table><thead><tr><th width="192">Parametre</th><th width="147.89192708333331">Tip</th><th>Açıklama</th></tr></thead><tbody><tr><td>IsFailure</td><td>bool</td><td>İşlem sırasında hata oluştuğunu belirtir. true ise hata vardır.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>İşlemin başarılı şekilde tamamlandığını gösterir.</td></tr><tr><td>Errors</td><td>Array</td><td>Servis çağrısında oluşan hata mesajlarını içeren liste.</td></tr><tr><td>Value</td><td>Array</td><td>Servisin başarılı olması durumunda dönen içerik bilgisini barındırır.</td></tr></tbody></table>

## Servis Cevap (Value)

<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>Id</td><td>Guid</td><td>Kampanyaya ait sistem tarafından üretilen eşsiz kimlik numarasıdır.</td></tr><tr><td>Name</td><td>string</td><td>Kampanyanın sistem üzerindeki tanımlı ad bilgisidir.</td></tr><tr><td>Description</td><td>string</td><td>Kampanya hakkında bilgi sağlayan açıklayıcı metindir.</td></tr><tr><td>MinimumDepositAmount</td><td>decimal</td><td>Kampanyanın geçerli olması için gereken en düşük yatırma miktarıdır.</td></tr><tr><td>MaximumDepositAmount</td><td>decimal</td><td>Kampanyadan faydalanmak için geçerli olan en yüksek yatırma sınırıdır.</td></tr><tr><td>BonusType</td><td>string</td><td>Bonusun türünü belirtir (örneğin: sabit tutar, oran).</td></tr><tr><td>BonusValue</td><td>decimal</td><td>Belirtilen kampanya kapsamındaki bonusun numeric değeri.</td></tr><tr><td>CampaignType</td><td>string</td><td>Kampanyanın ait olduğu kategori ya da kullanım türünü ifade eder.</td></tr><tr><td>StartDate</td><td>DateTime</td><td>Kampanyanın yürürlüğe girdiği tarih bilgisidir.</td></tr><tr><td>EndDate</td><td>DateTime</td><td>Kampanyanın geçerliliğinin sona ereceği tarihi gösterir.</td></tr><tr><td>IsActive</td><td>bool</td><td>Kampanyanın şu anda aktif olup olmadığını belirten durum değeridir.</td></tr><tr><td>MerchantId</td><td>Guid</td><td>Kampanyayı tanımlayan işyeri veya satıcının benzersiz kimlik bilgisidir.</td></tr><tr><td>TotalBonusGiven</td><td>decimal</td><td>Bu kampanya ile şimdiye kadar verilmiş toplam bonus tutarıdır.</td></tr><tr><td>CreatedAt</td><td>DateTime</td><td>Kaydın oluşturulduğu zamanı temsil eder.</td></tr><tr><td>UpdatedAt</td><td>DateTime</td><td>Son olarak güncellendiği tarihi gösterir.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.paywall.one/cuzdan-servisleri/7.-kampanya/3.-getir-name.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.