> 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/payment-orchestration-integration-document/wallet-services/2.-wallet/3.-fetch-by-walletowner.md).

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