# 3. Fetch (By WalletOwner)

## **Get Wallet List by WalletOwner**

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

{% hint style="info" %}
**Note:** Before using this service, it is mandatory to include the **apikeypublic** and **apiclientpublic** parameters in the **Header**.

[<mark style="color:green;">**WalletAPI Address**</mark>](/payment-orchestration-integration-document/environment.md)
{% endhint %}

**The parameters to be sent to the service are as follows:**

<table><thead><tr><th width="162">Parameter</th><th width="113.46875">Type</th><th width="148.52734375">Compulsory</th><th width="403">Description</th></tr></thead><tbody><tr><td>apikeypublic</td><td>string</td><td>Yes</td><td>A shared key used for authentication in API calls.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Yes</td><td>The public key sent to identify the client using the API.</td></tr><tr><td>PageSize</td><td>int</td><td>Yes</td><td>Number of records to be retrieved per page.</td></tr><tr><td>PageNumber</td><td>int</td><td>Yes</td><td>Page number</td></tr></tbody></table>

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

```json
{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Items": [
            {
                "Id": "7883fb19-2359-4a9b-b917-f08a259898ed",
                "WalletOwnerId": "0a949877-0ea0-48c3-9c92-41c9e33c461d",
                "Name": "External Test Wallet",
                "Alias": "2816220769",
                "RegionId": 1,
                "CurrencyCode": "",
                "Balance": 0.00,
                "AvailableBalance": 0,
                "TotalGiftBalance": 0,
                "BlockedBalance": 0,
                "FrozenUntil": "0001-01-01T00:00:00",
                "IsFrozen": false,
                "IsDeleted": false,
                "CreatedAt": "2025-08-20T10:05:51.956493Z",
                "UpdatedAt": null,
                "AllowOverdraft": false,
                "OverdraftLimit": 0
            }
        ],
        "PageNumber": 1,
        "TotalPages": 1,
        "TotalCount": 1,
        "HasPreviousPage": false,
        "HasNextPage": false
    }
}
```

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

## **Service Response**

<table><thead><tr><th width="192">Parameter</th><th width="147.89192708333331">Type</th><th>Description</th></tr></thead><tbody><tr><td>IsFailure</td><td>bool</td><td>This field indicates whether the request resulted in an error.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>An indicator showing whether the API operation was completed successfully.</td></tr><tr><td>Errors</td><td>Array</td><td>The data field that returns error records generated during the service execution.</td></tr><tr><td>Value</td><td>Array&#x3C;Items></td><td>Represents the main data content returned by the API.</td></tr></tbody></table>

## **Service Response (Value)**

<table><thead><tr><th width="234.05859375">Parameter</th><th width="162.38671875">Type</th><th width="348.94140625">Description</th></tr></thead><tbody><tr><td>Id</td><td>Guid</td><td>The unique identifier of the object defined in the system.</td></tr><tr><td>WalletOwnerId</td><td>Guid</td><td>The personal identification number belonging to the wallet owner.</td></tr><tr><td>Name</td><td>string</td><td>The field indicating the name or company name of the wallet owner.</td></tr><tr><td>Alias</td><td>string</td><td>The short name or alias assigned to the wallet.</td></tr><tr><td>MerchantId</td><td>Guid</td><td>The unique identifier of the merchant to which the wallet owner is linked.</td></tr><tr><td>RegionId</td><td>string</td><td>The region ID where the wallet owner is defined.</td></tr><tr><td>CurrencyCode</td><td>string</td><td>The international standard currency code of the transaction (e.g., TRY, USD, EUR).</td></tr><tr><td>Balance</td><td>decimal</td><td>The total amount of money in the wallet.</td></tr><tr><td>AvailableBalance</td><td>decimal</td><td>The available (usable) balance amount.</td></tr><tr><td>TotalGiftBalance</td><td>decimal</td><td>The total bonus balance available in the wallet.</td></tr><tr><td>BlockedBalance</td><td>decimal</td><td>The blocked balance amount that cannot be used for transactions.</td></tr><tr><td>FrozenUntil</td><td>DateTime</td><td>The duration until the wallet is temporarily suspended.</td></tr><tr><td>IsFrozen</td><td>bool</td><td>Indicates whether the wallet is currently frozen.</td></tr><tr><td>IsDeleted</td><td>bool</td><td>The status field showing whether the wallet record has been deleted from the system.</td></tr><tr><td>CreatedAt</td><td>DateTime</td><td>The date and time when the record was completed.</td></tr><tr><td>UpdatedAt</td><td>DateTime</td><td>The last update timestamp of the record.</td></tr><tr><td>TransactionId</td><td>Guid</td><td>The unique identifier assigned to the transaction record.</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/payment-orchestration-integration-document/wallet-services/2.-wallet/3.-fetch-by-walletowner.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.