3. Fetch (By WalletOwner)

You can use this service to list wallets belonging to a specific **WalletOwner**.

Get Wallet List by WalletOwner

GET{{WalletUrl}}/api/v1/wallet/by/walletowner/:walletownerid

Note: Before using this service, it is mandatory to include the apikeypublic and apiclientpublic parameters in the Header.

WalletAPI Address

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

Parameter	Type	Compulsory	Description
apikeypublic	string	Yes	A shared key used for authentication in API calls.
apiclientpublic	string	Yes	The public key sent to identify the client using the API.
PageSize	int	Yes	Number of records to be retrieved per page.
PageNumber	int	Yes	Page number

Service Response - 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
    }
}

Service Response

Parameter	Type	Description
IsFailure	bool	This field indicates whether the request resulted in an error.
IsSuccess	bool	An indicator showing whether the API operation was completed successfully.
Errors	Array	The data field that returns error records generated during the service execution.
Value	Array<Items>	Represents the main data content returned by the API.

Service Response (Value)

Parameter	Type	Description
Id	Guid	The unique identifier of the object defined in the system.
WalletOwnerId	Guid	The personal identification number belonging to the wallet owner.
Name	string	The field indicating the name or company name of the wallet owner.
Alias	string	The short name or alias assigned to the wallet.
MerchantId	Guid	The unique identifier of the merchant to which the wallet owner is linked.
RegionId	string	The region ID where the wallet owner is defined.
CurrencyCode	string	The international standard currency code of the transaction (e.g., TRY, USD, EUR).
Balance	decimal	The total amount of money in the wallet.
AvailableBalance	decimal	The available (usable) balance amount.
TotalGiftBalance	decimal	The total bonus balance available in the wallet.
BlockedBalance	decimal	The blocked balance amount that cannot be used for transactions.
FrozenUntil	DateTime	The duration until the wallet is temporarily suspended.
IsFrozen	bool	Indicates whether the wallet is currently frozen.
IsDeleted	bool	The status field showing whether the wallet record has been deleted from the system.
CreatedAt	DateTime	The date and time when the record was completed.
UpdatedAt	DateTime	The last update timestamp of the record.
TransactionId	Guid	The unique identifier assigned to the transaction record.