3. Retrieve

To retrieve the details of a specific wallet owner, the service on this page should be used with the appropriate parameters.

Retrieve Wallet Owner Details

GET {{WalletUrl}}/api/v1/walletowner/by/id/529a2e8a-fd42-43d5-a87f-49b3c6a5c145

Note: Before calling this service, you must include the apikeypublic and apiclientpublic parameters in the Header section.

WalletAPI Address

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

Parameter	Type	Compulsory	Description
apikeypublic	string	Yes	A public key generated through the merchant panel, used for authentication in API calls.
apiclientpublic	string	Yes	A public client key generated through the merchant panel, used to identify the client information during API access.

Service Response - JSON

{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "1223f471-ae54-493d-a7ba-8b138949e962",
        "Fullname": "Enes Selman",
        "Email": "[e-mail]",
        "PhoneNumber": "[phone]",
        "TaxNumber": "",
        "IdentityNumber": "43276603742",
        "OwnerType": "Individual",
        "CompanyName": "test",
        "Address": "address",
        "Country": "country",
        "City": "city",
        "DateOfBirth": "2030-10-15",
        "CreatedAt": "2025-08-16T19:16:08.211642Z",
        "UpdatedAt": null
    }
}

Service Response

Parameter	Type	Description
IsFailure	bool	Indicates whether the API response contains a failure. If it returns true, it means the operation has failed. Should be considered in control mechanisms.
IsSuccess	bool	A boolean value indicating that the operation was successfully completed by the system. Returns true for successful operations. Used in validation processes.
Errors	Array	Contains details of errors that may occur during the service call. Error descriptions are usually returned along with error codes. Indicates the source of the problem in the response.
Value	Array<Items>	Represents the main data output of the API call. The returned response is delivered through this field. The data type it contains depends on the endpoint used.

Service Response (Value)

Parameter	Type	Description
Id	Guid	A unique identifier assigned by the system specifically to the wallet owner. Used as a reference in other operations.
Fullname	string	The full name field that combines the user's first and last name. Used for display in user interfaces.
Email	string	The registered email address of the wallet owner. Communication and notification services operate through this field.
PhoneNumber	string	Contains the user's mobile phone information. Processed during login and verification steps.
TaxNumber	string	The tax identification number used for users with tax liabilities. Checked in transaction restrictions.
IdentityNumber	string	A national identity number specifically assigned to individuals. Used in transactions that require identity verification.
OwnerType	string	Specifies the type of the wallet owner defined in the system. It can take values such as MERCHANT or SUB_MERCHANT.
CompanyName	string	The company name of corporate users is stored in this field. Displayed in corporate profiles.
Address	string	The address provided by the wallet owner. Required for physical transactions or reporting.
Country	string	The country information provided by the user during registration. The service scope can be filtered based on this field.
City	string	The city information of the wallet owner. Suitable for location-based analysis.
DateOfBirth	Date	The date of birth of individual users. Queried for age-related transaction checks.
MerchantId	int	The system ID of the merchant to which the wallet owner is associated. Subordinate records are linked with this ID.
CreatedAt	DateTime	The date and time when the user record was created is stored in this field. Used in system tracking processes.
UpdatedAt	DateTime	Indicates when the wallet owner's data was last updated. Change tracking is performed using this field.