7. Query by Tax Number

To access the wallet owner record by the specified tax number, this service must be used with the required parameters.

Identify Wallet Record by Tax Number

GET {{WalletUrl}}/api/v1/walletowner/by/taxnumber?TaxNumber=5049155355

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 API service requests.
apiclientpublic	string	Yes	It is the public client key used to specify which client the API call is coming from.

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

Parameter	Description
TaxNumber	The tax number information of the wallet owner you want to query.

Service Response - JSON

{
    "Value": {
        "Id": "b5708099-be62-4d34-af06-27132082eb78",
        "MaskedFullname": "y***t",
        "Email": "[email protected]",
        "PhoneNumber": "[phone]",
        "MaskedTaxNumber": "50*******5",
        "MaskedIdentityNumber": null,
        "OwnerType": "Corporate",
        "CompanyName": "Prosacco - McCullough",
        "Address": "address",
        "Country": "country",
        "City": "city",
        "DateOfBirth": "2030-10-15",
        "MerchantId": 2071,
        "CreatedAt": "2025-04-24T09:00:55.692674Z",
        "UpdatedAt": null,
        "Wallets": []
    },
    "Errors": [],
    "IsSuccess": true,
    "IsFailure": false
}

Service Response

Parameter	Type	Description
IsFailure	bool	Yapılan API çağrısının başarısız olup olmadığını belirten değerdir. (true/false)
IsSuccess	bool	Yapılan API çağrısının başarılı olup olmadığını belirten değerdir. (true/false)
Errors	Array	Servis çağrısı sırasında oluşan hata mesajlarını ve detaylarını içeren alandır.
Value	Array<Items>	Başarılı API çağrısında dönen asıl veri kümesini temsil eder.

Service Response (Value)

Parameter	Type	Description
Id	Guid	It is the unique identifier of the entity defined in the system.
MaskedFullname	string	It is the information 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 number where the user's tax number is displayed in a masked (hidden) format.
MaskedIdentityNumber	string	It is the information where the user's identity number is displayed in a masked (hidden) format.
OwnerType	string	It specifies the type of the wallet owner (indicating whether they are an individual user or a corporate entity).
CompanyName	string	If the wallet owner is corporate, it displays the registered company name.
Address	string	It is the wallet owner's registered full address.
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 merchant ID number associated with the relevant user.
CreatedAt	DateTime	It is the date and time when the record was created in the system.
UpdatedAt	DateTime	It is the date and time when the record was last updated.
Wallets	List	It is the field containing the list of wallet information associated with the user.