> 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/1.-wallet-owners/3.-retrieve.md).

# 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>](/payment-orchestration-integration-document/environment.md)
{% endhint %}

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

<table><thead><tr><th width="162">Parameter</th><th width="114.109375">Type</th><th width="139.25">Compulsory</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
{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "1223f471-ae54-493d-a7ba-8b138949e962",
        "Fullname": "Enes Selman",
        "Email": "Litzy_Zboncak@gmail.com",
        "PhoneNumber": "+9052323230004",
        "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
    }
}
```

{% 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>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://developer.paywall.one/payment-orchestration-integration-document/wallet-services/1.-wallet-owners/3.-retrieve.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.