6. Query by Identity

The service on this page must be used with the required parameters to query the existing wallet owner record by the specified identity information.

Identify Wallet Record by Identity

GET {{WalletUrl}}/api/v1/walletowner/by/identity?Identity=68567422314

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	Required	Description
apikeypublic	string	Yes	It is the public key used for authentication in service calls.
apiclientpublic	string	Yes	It is the public key used to specify the identity of the API client.

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

Parameter	Description
Identity	The identity information of the wallet owner you want to query.

Service Request - JSON

{
    "Value": {
        "Id": "9ef565a2-5987-4da4-8b0e-f0b392196e7e",
        "MaskedFullname": "y***t",
        "Email": "[email protected]",
        "PhoneNumber": "[phone]",
        "MaskedTaxNumber": "",
        "MaskedIdentityNumber": "685******14",
        "OwnerType": "Individual",
        "CompanyName": "Schuster - Labadie",
        "Address": "57152 Koepp Prairie",
        "Country": "Senegal",
        "City": "Volkmanberg",
        "DateOfBirth": "2001-03-03",
        "MerchantId": 2071,
        "CreatedAt": "2025-04-22T12:40:20.724936Z",
        "UpdatedAt": "2025-04-22T12:41:09.156117Z",
        "Wallets": []
    },
    "Errors": [],
    "IsSuccess": true,
    "IsFailure": false
}

Service Response

Parameter	Type	Description
IsFailure	bool	Indicates whether the related service call has failed or not. (true/false)
IsSuccess	bool	Indicates whether the related service call was successful or not. (true/false)
Errors	Array	The area where error messages occurring during the service call are listed.
Value	Array<Items>	The area representing the main data object returned by the service.

Service Response (Value)

Parameter	Type	Description
Id	Guid	It is the unique identifier of the entity recorded in the system.
MaskedFullname	string	It is the field where the user's full name is displayed in a masked (hidden) format.
Email	string	It is the user's registered email address.
PhoneNumber	string	It is the user's registered phone number.
MaskedTaxNumber	string	It is the field where the user's tax number is displayed in a masked (hidden) format.
MaskedIdentityNumber	string	It is the field where the user's identity number is displayed in a masked (hidden) format.
OwnerType	string	It is the field that specifies whether the wallet owner is an individual or a corporate entity.
CompanyName	string	It is the registered company name of the wallet owner (if applicable).
Address	string	It is the field containing the registered address information of the wallet owner.
Country	string	It is the country information where the wallet owner is registered.
City	string	It is the city information where the wallet owner is registered.
DateOfBirth	Date	It is the date of birth of the wallet owner.
MerchantId	int	It is the date of birth of the wallet owner.
CreatedAt	DateTime	Indicates the creation time of the record.
UpdatedAt	DateTime	Indicates the last updated time of the record.
Wallets	List	It is the field representing the list of wallets associated with the user.