# 2. Getir (By-Alias)

## Alias Bilgisine Göre Kayıt Getir  

<mark style="color:green;">`GET`</mark>`{{WalletUrl}}/api/v1/wallet/by/alias/:alias`

{% hint style="info" %}
Not: Bu servisten faydalanmadan önce **apikeypublic** ve **apiclientpublic** parametrelerinin Header alanına eklenmesi 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>API çağrılarında kimlik doğrulaması sağlamak için kullanılan ortak anahtar bilgisidir.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Evet</td><td>API'yi kullanan istemcinin kimliğini göstermek için gönderilen açık anahtar bilgisidir.</td></tr></tbody></table>

{% tabs %}
{% tab title="Servis Cevap - Json" %}
{% code lineNumbers="true" %}

```json
{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "e75df134-185a-4b2b-b501-719dba2129c4",
        "WalletOwnerId": "0a949877-0ea0-48c3-9c92-41c9e33c461d",
        "Name": "External Test Wallet",
        "Alias": "5746347646",
        "RegionId": 1,
        "CurrencyCode": "TRY",
        "Balance": 0.00,
        "AvailableBalance": 0,
        "TotalGiftBalance": 0,
        "BlockedBalance": 0,
        "FrozenUntil": "0001-01-01T00:00:00",
        "IsFrozen": false,
        "IsDeleted": false,
        "CreatedAt": "2025-08-20T10:04:01.365948Z",
        "UpdatedAt": null,
        "AllowOverdraft": false,
        "OverdraftLimit": 0
    }
}
```

{% 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>Yapılan isteğin hata ile sonuçlanıp sonuçlanmadığını gösteren bilgi alanıdır.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>Yapılan API işleminin başarılı şekilde tamamlanıp tamamlanmadığını bildiren ifadedir.</td></tr><tr><td>Errors</td><td>Array</td><td>Servis çalışması sırasında oluşan hata kayıtlarının döndüğü veri alanıdır.</td></tr><tr><td>Value</td><td>Array&#x3C;Items></td><td>API tarafından döndürülen temel veri içeriğini temsil eder.</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>Sistemde tanımlı nesnenin benzersiz kimlik numarasıdır.</td></tr><tr><td>WalletOwnerId</td><td>Guid</td><td>Cüzdan sahibine ait olan özel kimlik numarası bilgisidir.</td></tr><tr><td>Name</td><td>string</td><td>Cüzdan sahibinin adı veya firma ismini belirten bilgi alanıdır.</td></tr><tr><td>Alias</td><td>string</td><td>Cüzdana atanmış kısa ad veya alternatif isim bilgisidir.</td></tr><tr><td>MerchantId</td><td>Guid</td><td>Cüzdan sahibinin bağlı olduğu üye iş yerinin benzersiz kimliğidir.</td></tr><tr><td>RegionId</td><td>string</td><td>Cüzdan sahibinin tanımlı olduğu coğrafi bölge kimlik numarasıdır.</td></tr><tr><td>CurrencyCode</td><td>string</td><td>İşlem yapılan para biriminin uluslararası standart kodudur (örn: TRY, USD, EUR).</td></tr><tr><td>Balance</td><td>decimal</td><td>Cüzdandaki toplam para miktarını gösterir.</td></tr><tr><td>AvailableBalance</td><td>decimal</td><td>Kullanılabilir (işleme açık) bakiye tutarını belirtir.</td></tr><tr><td>TotalGiftBalance</td><td>decimal</td><td>Cüzdanda bulunan toplam hediye bakiye miktarıdır.</td></tr><tr><td>BlockedBalance</td><td>decimal</td><td>İşlem yapılamayan bloke edilen bakiye miktarıdır.</td></tr><tr><td>FrozenUntil</td><td>DateTime</td><td>Cüzdanın geçici olarak kullanımının durdurulduğu zamana kadar olan süredir.</td></tr><tr><td>IsFrozen</td><td>bool</td><td>Cüzdanın şu anda dondurulmuş durumda olup olmadığını belirten göstergedir.</td></tr><tr><td>IsDeleted</td><td>bool</td><td>Cüzdan kaydının sistemden silinip silinmediğini gösteren durum alanıdır.</td></tr><tr><td>CreatedAt</td><td>DateTime</td><td>Kayıt işleminin tamamlandığı tarih ve saat bilgisidir.</td></tr><tr><td>UpdatedAt</td><td>DateTime</td><td>Kaydın en son ne zaman güncellendiğini gösteren zaman bilgisidir.</td></tr><tr><td>TransactionId</td><td>Guid</td><td>İşlem kaydına atanmış benzersiz kimlik numarasıdır.</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/2.-cuzdan/2.-getir-by-alias.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.