> 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/3.-transactions/3.-fetch-by-walletowner.md).

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