> 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/2.-cuzdan/3.-getir-by-alias.md).

# 3. Getir (By-Alias)

## Alias Bilgisine Göre Kayıt Getir  

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

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

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

</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>Yapılan işlemin başarısızlıkla sonuçlanıp sonuçlanmadığını belirten bilgi alanıdır.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>API çağrısının başarılı tamamlanıp tamamlanmadığını ifade eder.</td></tr><tr><td>Errors</td><td>Array</td><td>Servis sırasında karşılaşılan hata kayıtlarının listelendiği veri alanıdır.</td></tr><tr><td>Value</td><td>Array&#x3C;Items></td><td>API yanıtı içerisinde dönen ana veri nesnesini temsil eder.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > Id</td><td>Guid</td><td>İlgili kaydın sistemdeki benzersiz kimlik numarasıdır.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > WalletOwnerId</td><td>Guid</td><td>Cüzdan sahibine ait olan eşsiz kimlik numarasıdır.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > Name</td><td>string</td><td>Cüzdan adı veya unvan bilgisidir.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > Alias</td><td>string</td><td>Cüzdana tanımlanan takma ad veya kısa isim bilgisidir.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > RegionId</td><td>string</td><td>Cüzdan sahibinin ilişkilendirildiği coğrafi bölge kimlik numarasıdır.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > CurrencyCode</td><td>string</td><td>Cüzdanın bağlı olduğu para biriminin kod bilgisidir (örneğin: TRY, USD).</td></tr><tr><td><mark style="color:yellow;">Value</mark> > Balance</td><td>decimal</td><td>Cüzdanın toplam bakiyesini gösteren finansal değerdir.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > AvailableBalance</td><td>decimal</td><td>İşlem yapmaya uygun olan kullanılabilir bakiye bilgisidir.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > TotalGiftBalance</td><td>decimal</td><td>Cüzdanda yer alan toplam hediye bakiyesi miktarıdır.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > BlockedBalance</td><td>decimal</td><td>Kullanımı kısıtlanmış olan bloke bakiye miktarıdır.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > FrozenUntil</td><td>DateTime</td><td>Cüzdanın dondurulmuş olduğu tarih ve saat bilgisi.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > IsFrozen</td><td>bool</td><td>Cüzdanın aktif olarak dondurulmuş (freeze) durumda olup olmadığını belirten alandır.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > IsDeleted</td><td>bool</td><td>Cüzdanın sistemde silinip silinmediğini belirten işaret alanıdır.</td></tr><tr><td><mark style="color:yellow;">Value</mark> >CreatedAt</td><td>DateTime</td><td>Kaydın oluşturulduğu tarih ve zaman damgasıdır.</td></tr><tr><td><mark style="color:yellow;">Value</mark> >  UpdatedAt</td><td>DateTime</td><td>Kaydın sistemde en son güncellendiği tarih ve saat bilgisidir.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > AllowOverdraft</td><td>bool</td><td>Cüzdanın eksi bakiyeye düşmesine izin verilip verilmediğini belirtir.<code>true</code> ise bakiye sıfırın altına inebilir.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > OverdraftLimit</td><td>decimal</td><td>Cüzdanın düşebileceği maksimum eksi bakiye limitini belirtir.<code>AllowOverdraft = true</code> olduğunda geçerlidir.</td></tr></tbody></table>

</details>

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