# 3. Retrieve

## Retrieve Wallet Owner Details

<mark style="color:green;">`GET`</mark> `{{WalletUrl}}/api/v1/walletowner/by/id/529a2e8a-fd42-43d5-a87f-49b3c6a5c145`

{% hint style="info" %}
**Note:** Before calling this service, you must include the apikeypublic and apiclientpublic parameters in the Header section.

[<mark style="color:green;">**WalletAPI Address**</mark>](https://developer.paywall.one/payment-orchestration-integration-document/environment)
{% endhint %}

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

<table><thead><tr><th width="162">Parameter</th><th width="79">Type</th><th width="107">Required</th><th width="403">Description</th></tr></thead><tbody><tr><td>apikeypublic</td><td>string</td><td>Yes</td><td>A public key generated through the merchant panel, used for authentication in API calls.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Yes</td><td>A public client key generated through the merchant panel, used to identify the client information during API access.</td></tr></tbody></table>

{% tabs %}
{% tab title="Service Response - JSON" %}
{% code lineNumbers="true" %}

```json
{
    "Value": {
        "Id": "529a2e8a-fd42-43d5-a87f-49b3c6a5c145",
        "Fullname": "yiğit",
        "Email": "Ciara_Vandervort@hotmail.com",
        "PhoneNumber": "+9052323221591",
        "TaxNumber": "",
        "IdentityNumber": "11111111110",
        "OwnerType": "Individual",
        "CompanyName": "Gutkowski - Turcotte",
        "Address": "address",
        "Country": "country",
        "City": "city",
        "DateOfBirth": "2030-10-15",
        "MerchantId": 2071,
        "CreatedAt": "2025-04-21T20:11:59.611512Z",
        "UpdatedAt": null
    },
    "Errors": [],
    "IsSuccess": true,
    "IsFailure": 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>Indicates whether the API response contains a failure. If it returns true, it means the operation has failed. Should be considered in control mechanisms.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>A boolean value indicating that the operation was successfully completed by the system. Returns true for successful operations. Used in validation processes.</td></tr><tr><td>Errors</td><td>Array</td><td>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.</td></tr><tr><td>Value</td><td>Array&#x3C;Items></td><td>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.</td></tr></tbody></table>

## Service Response (Value)

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