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.

{
    "Value": {
        "Id": "9ef565a2-5987-4da4-8b0e-f0b392196e7e",
        "MaskedFullname": "y***t",
        "Email": "[email protected]",
        "PhoneNumber": "+905343664456",
        "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.

Last updated