Resolve Login Identities

post/api/accounts/{partnerAccountId}/resolve-login-identities

Resolves which of the supplied wallet addresses are login identifiers and what accounts they reach, within the partner account named in the URL. Each matched address returns the owning user with their identity account and the cardholder accounts under the requesting partner. Addresses with no login wallet are omitted from the response, so an address that is absent from items is unknown to Immersve under the requesting partner.

Request

Path Parameters

partnerAccountIdstringrequired
Id of the partner account that scopes the resolution.

Body application/json

walletAddressesstring[]requiredmin items: 1max items: 50
EVM wallet addresses to resolve. Addresses are normalized before lookup, so any casing is accepted; duplicate addresses are deduplicated.

Response

Successful operation.

Body application/json

itemsobject[]
One entry per matched login identifier. Requested addresses with no match are omitted.
Items
- typestring
  Allowed values:wallet
  The kind of login identifier that matched.
- walletAddressstring
  The matched wallet address in normalized (EIP-55 checksummed) form.
- walletAddressTypestring
  Allowed values:eth
  The wallet address type of the matched login identifier.
- userIdstring
  Id of the user that completed Sign-In-With-Ethereum with this wallet.
- accountsobject[]
  The user's identity account plus the cardholder accounts under the requesting partner.
  Items
  accountIdstring
  Id of the account.
  accountTypestring
  Allowed values:identitycardholder
  The type of the account.
  partnerAccountIdstring
  Id of the partner account the cardholder account belongs to. Present on cardholder accounts only.

Request fields are invalid: an empty address list, more than 50 addresses, or an address that is not a well-formed EVM address.

Body application/json

statusCodeintegerrequired
statusNamestringrequired
errorCodestringrequired
errorsobject[]
Items
- messagestring
- pathstring
  The location of the invalid path param, query param or payload attribute.

User is not allowed to perform the action with the reason stated in the errorCode.

FORBIDDEN The credentials do not permit resolving login identities for the requested partner account.

Body application/json

statusCodeintegerrequired
statusNamestringrequired
errorCodestringrequired
reasonstring

Example

Example Request

ServerAuthentication

curl 'https://api.immersve.com/api/accounts/{partnerAccountId}/resolve-login-identities' \
  --request POST \
  --header 'Authorization: Bearer <access-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "walletAddresses": [
    "0x8ba1f109551bD432803012645Ac136ddd64DBA72"
  ]
}'

curl 'https://api.immersve.com/api/accounts/{partnerAccountId}/resolve-login-identities' \
  --request POST \
  --header 'Authorization: Bearer <access-token>' \
  --header 'X-Account-Id: <target-account>' \
  --header 'Content-Type: application/json' \
  --data '{
  "walletAddresses": [
    "0x8ba1f109551bD432803012645Ac136ddd64DBA72"
  ]
}'

curl 'https://api.immersve.com/api/accounts/{partnerAccountId}/resolve-login-identities' \
  --request POST \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Api-Secret: <api-secret>' \
  --header 'Content-Type: application/json' \
  --data '{
  "walletAddresses": [
    "0x8ba1f109551bD432803012645Ac136ddd64DBA72"
  ]
}'

curl 'https://api.immersve.com/api/accounts/{partnerAccountId}/resolve-login-identities' \
  --request POST \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Api-Secret: <api-secret>' \
  --header 'X-Account-Id: <target-account>' \
  --header 'Content-Type: application/json' \
  --data '{
  "walletAddresses": [
    "0x8ba1f109551bD432803012645Ac136ddd64DBA72"
  ]
}'

curl 'https://test.immersve.com/api/accounts/{partnerAccountId}/resolve-login-identities' \
  --request POST \
  --header 'Authorization: Bearer <access-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "walletAddresses": [
    "0x8ba1f109551bD432803012645Ac136ddd64DBA72"
  ]
}'

curl 'https://test.immersve.com/api/accounts/{partnerAccountId}/resolve-login-identities' \
  --request POST \
  --header 'Authorization: Bearer <access-token>' \
  --header 'X-Account-Id: <target-account>' \
  --header 'Content-Type: application/json' \
  --data '{
  "walletAddresses": [
    "0x8ba1f109551bD432803012645Ac136ddd64DBA72"
  ]
}'

curl 'https://test.immersve.com/api/accounts/{partnerAccountId}/resolve-login-identities' \
  --request POST \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Api-Secret: <api-secret>' \
  --header 'Content-Type: application/json' \
  --data '{
  "walletAddresses": [
    "0x8ba1f109551bD432803012645Ac136ddd64DBA72"
  ]
}'

curl 'https://test.immersve.com/api/accounts/{partnerAccountId}/resolve-login-identities' \
  --request POST \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Api-Secret: <api-secret>' \
  --header 'X-Account-Id: <target-account>' \
  --header 'Content-Type: application/json' \
  --data '{
  "walletAddresses": [
    "0x8ba1f109551bD432803012645Ac136ddd64DBA72"
  ]
}'

Example Response

{
  "items": [
    {
      "type": "wallet",
      "walletAddress": "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
      "walletAddressType": "eth",
      "userId": "1279710a642d4c0e",
      "accounts": [
        {
          "accountId": "4f6f5c2a3d1e4b0a",
          "accountType": "cardholder",
          "partnerAccountId": "225d85e65495722bf6517ea0ba0d6f56"
        }
      ]
    }
  ]
}

{
  "statusCode": 400,
  "statusName": "Bad Request",
  "errorCode": "INVALID_REQUEST_INPUT",
  "errors": [
    {
      "message": "Invalid type",
      "path": "items[1].attributes.invalidField"
    }
  ]
}

{
  "statusCode": 403,
  "statusName": "Forbidden",
  "errorCode": "FORBIDDEN",
  "reason": "Unauthorized"
}