# 3. Fetch by WalletOwner

## **Identify Wallet Record by WalletOwnerId**

<mark style="color:green;">`GET`</mark> `{{WalletUrl}}/api/v1/wallet/transaction/by/walletowner/:walletOwnerId?Page=1&PageSize=10&StartDate=2025-03-24T20:26:25.426Z&EndDate=2025-04-29T20:26:25.426Z&TransactionType=1`

{% hint style="info" %}
**Note:** Before calling this service, you must 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="92.54296875">Type</th><th width="147.484375">Compolsory</th><th width="403">Description</th></tr></thead><tbody><tr><td>apikeypublic</td><td>string</td><td>Yes</td><td>The public key used for authentication in API access.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Yes</td><td>The public client key that indicates which client the request originates from.</td></tr></tbody></table>

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

```json
{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Items": [
            {
                "Id": "e1e2f263-7c0c-4997-a6c9-3e70de4ebda5",
                "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
                "Alias": "2816220769",
                "TransactionType": "Deposit",
                "Amount": 100000.00,
                "GiftAmount": null,
                "Description": "string",
                "ExternalReference": "5bc276c8-acb5-4cb7-90fe-1d3ff10fbcfb",
                "CreatedAt": "2025-08-20T11:56:17.206107Z",
                "UpdatedAt": null,
                "BalanceAfterTransaction": 100000.80,
                "BlockedBalanceAfterTransaction": 0.00,
                "AvailableBalanceAfterTransaction": 100000.80,
                "GiftBalanceBalanceAfterTransaction": 0.00,
                "CurrencyCode": "TRY",
                "SourceWalletId": null,
                "DestinationWalletId": null,
                "GiftBalanceId": null,
                "MainTransactionId": null,
                "UniqueCode": "9dd0b65f-05b8-498b-b8d9-3c4adaa27731",
                "UsedGiftBalances": null,
                "CashbackAmount": 0
            },
            {
                "Id": "8adb2cbe-00ac-4a8b-befe-0fb204db6366",
                "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
                "Alias": "2816220769",
                "TransactionType": "Deposit",
                "Amount": 1.00,
                "GiftAmount": null,
                "Description": "string",
                "ExternalReference": "2679c1c1-64cb-42d8-bb2f-af0970c1998a",
                "CreatedAt": "2025-08-20T10:10:20.63054Z",
                "UpdatedAt": null,
                "BalanceAfterTransaction": 3.00,
                "BlockedBalanceAfterTransaction": 0.00,
                "AvailableBalanceAfterTransaction": 3.00,
                "GiftBalanceBalanceAfterTransaction": 0.00,
                "CurrencyCode": "TRY",
                "SourceWalletId": null,
                "DestinationWalletId": null,
                "GiftBalanceId": null,
                "MainTransactionId": null,
                "UniqueCode": "35191319-3d79-472b-be04-0e98df27c4bd",
                "UsedGiftBalances": null,
                "CashbackAmount": 0
            },
            {
                "Id": "aa230ce5-127d-44a0-b480-7f9c4a24a9fd",
                "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
                "Alias": "2816220769",
                "TransactionType": "Deposit",
                "Amount": 1.00,
                "GiftAmount": null,
                "Description": "string",
                "ExternalReference": "4dcac110-5511-4cdf-9047-c27bfdb203fb",
                "CreatedAt": "2025-08-20T10:09:37.007461Z",
                "UpdatedAt": null,
                "BalanceAfterTransaction": 1.00,
                "BlockedBalanceAfterTransaction": 0.00,
                "AvailableBalanceAfterTransaction": 1.00,
                "GiftBalanceBalanceAfterTransaction": 0.00,
                "CurrencyCode": "TRY",
                "SourceWalletId": null,
                "DestinationWalletId": null,
                "GiftBalanceId": null,
                "MainTransactionId": null,
                "UniqueCode": "33bb4315-cb53-4f43-819c-b4bced99605f",
                "UsedGiftBalances": null,
                "CashbackAmount": 0
            }
        ],
        "PageNumber": 1,
        "TotalPages": 1,
        "TotalCount": 3,
        "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>A boolean value indicating whether the related service operation has failed.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>Indicates whether the service has been completed successfully.</td></tr><tr><td>Errors</td><td>Array</td><td>Contains the error messages that may occur during the service execution.</td></tr><tr><td>HasNextPage</td><td>bool</td><td>Indicates whether there is a next page in pagination.</td></tr><tr><td>HasPreviousPage</td><td>bool</td><td>Indicates whether there is a previous page.</td></tr><tr><td>TotalCount</td><td>int</td><td>Represents the total number of records queried.</td></tr><tr><td>TotalPages</td><td>int</td><td>Indicates how many pages the results are spread across.</td></tr><tr><td>PageNumber</td><td>int</td><td>Indicates the current page number being viewed.</td></tr><tr><td>Items</td><td>List</td><td>Contains the list of data objects returned within the page.</td></tr></tbody></table>

## **Service Response** (Items)

<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>Represents the unique identifier of the record or transaction in the system</td></tr><tr><td>WalletId</td><td>Guid</td><td>The unique ID of the wallet where the related transaction took place</td></tr><tr><td>TransactionType</td><td>string</td><td>Defines the category of the transaction (e.g., payment, refund, transfer)</td></tr><tr><td>Amount</td><td>decimal</td><td>Represents the total amount used within the transaction</td></tr><tr><td>GiftAmount</td><td>decimal</td><td>The amount used from the bonus balance in the transaction</td></tr><tr><td>Description</td><td>string</td><td>A short descriptive field related to the transaction</td></tr><tr><td>ExternalReference</td><td>string</td><td>A reference code defined in an external system</td></tr><tr><td>CreatedAt</td><td>DateTime</td><td>Indicates the timestamp when the transaction was created</td></tr><tr><td>UpdatedAt</td><td>DateTime</td><td>The last updated timestamp of the transaction</td></tr><tr><td>BalanceAfterTransaction</td><td>decimal</td><td>The current remaining wallet balance after the transaction</td></tr><tr><td>SourceWalletId</td><td>Guid</td><td>Indicates the wallet ID from which the funds were deducted</td></tr><tr><td>DestinationWalletId</td><td>Guid</td><td>The wallet ID of the destination where the funds were sent</td></tr><tr><td>GiftBalanceId</td><td>int</td><td>The ID of the bonus balance used in the transaction</td></tr><tr><td>MainTransactionId</td><td>Guid</td><td>The ID of the main (parent) transaction if this transaction is linked</td></tr><tr><td>UniqueCode</td><td>string</td><td>A unique identifier code generated specifically for the transaction</td></tr><tr><td>UsedGiftBalances</td><td>List</td><td>The field where the bonus balances in use are listed</td></tr><tr><td>CashbackAmount</td><td>decimal</td><td>Indicates the cashback amount provided to the user after the transaction</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/3.-transactions/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.