Skip to main content
GET
/
sdk
/
{environmentId}
/
waas
/
byWalletAddress
/
{walletAddress}
Fetch a single WaaS wallet with verified credentials
curl --request GET \
  --url https://app.dynamicauth.com/api/v0/sdk/{environmentId}/waas/byWalletAddress/{walletAddress} \
  --header 'Authorization: Bearer <token>'
{
  "id": "95b11417-f18f-457f-8804-68e361f9164f",
  "projectEnvironmentId": "95b11417-f18f-457f-8804-68e361f9164f",
  "verifiedCredentials": [
    {
      "id": "95b11417-f18f-457f-8804-68e361f9164f",
      "format": "blockchain",
      "signInEnabled": true,
      "address": "0xbF394748301603f18d953C90F0b087CBEC0E1834",
      "chain": "<string>",
      "refId": "95b11417-f18f-457f-8804-68e361f9164f",
      "signerRefId": "95b11417-f18f-457f-8804-68e361f9164f",
      "email": "jsmith@example.com",
      "name_service": {
        "avatar": "<string>",
        "name": "<string>"
      },
      "public_identifier": "<string>",
      "wallet_name": "<string>",
      "wallet_provider": "browserExtension",
      "wallet_properties": {
        "turnkeySubOrganizationId": "95b11417-f18f-457f-8804-68e361f9164f",
        "turnkeyPrivateKeyId": "95b11417-f18f-457f-8804-68e361f9164f",
        "turnkeyHDWalletId": "95b11417-f18f-457f-8804-68e361f9164f",
        "isAuthenticatorAttached": true,
        "turnkeyUserId": "95b11417-f18f-457f-8804-68e361f9164f",
        "isSessionKeyCompatible": true,
        "version": "V1",
        "ecdsaProviderType": "zerodev_signer_to_ecdsa",
        "entryPointVersion": "v6",
        "kernelVersion": "v2_4"
      },
      "oauth_provider": "emailOnly",
      "oauth_username": "<string>",
      "oauth_display_name": "<string>",
      "oauth_account_id": "<string>",
      "phoneNumber": "9171113333",
      "phoneCountryCode": "1",
      "isoCountryCode": "US",
      "oauth_account_photos": [
        "<string>"
      ],
      "oauth_emails": [
        "<string>"
      ],
      "oauth_metadata": {},
      "previous_users": [
        "95b11417-f18f-457f-8804-68e361f9164f"
      ],
      "embedded_wallet_id": "<string>",
      "wallet_additional_addresses": [
        {
          "address": "<string>",
          "type": "ordinals",
          "publicKey": "<string>"
        }
      ],
      "lastSelectedAt": "2023-11-07T05:31:56Z",
      "verifiedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "lastVerifiedCredentialId": "95b11417-f18f-457f-8804-68e361f9164f",
  "sessionId": "95b11417-f18f-457f-8804-68e361f9164f",
  "alias": "An example name",
  "country": "US",
  "email": "jsmith@example.com",
  "firstName": "An example name",
  "jobTitle": "An example name",
  "lastName": "An example name",
  "phoneNumber": "<string>",
  "policiesConsent": true,
  "tShirtSize": "An example name",
  "team": "An example name",
  "username": "An example name",
  "firstVisit": "2023-11-07T05:31:56Z",
  "lastVisit": "2023-11-07T05:31:56Z",
  "newUser": true,
  "metadata": {},
  "mfaBackupCodeAcknowledgement": "pending",
  "btcWallet": "<string>",
  "kdaWallet": "<string>",
  "ltcWallet": "<string>",
  "ckbWallet": "<string>",
  "kasWallet": "<string>",
  "dogeWallet": "<string>",
  "emailNotification": true,
  "discordNotification": true,
  "newsletterNotification": true,
  "lists": [
    "<string>"
  ],
  "scope": "superuser marketing operations",
  "missingFields": [
    {
      "name": "<string>",
      "required": true,
      "enabled": true,
      "unique": true,
      "verify": true,
      "type": "standard",
      "validationRules": {
        "unique": true,
        "regex": "^0x",
        "validOptions": [
          {
            "label": "small"
          },
          {
            "label": "medium"
          },
          {
            "label": "large"
          }
        ],
        "checkboxText": "Agree to the terms and conditions"
      },
      "validationType": "text",
      "label": "<string>",
      "position": 123
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
environmentId
string
required

ID of the environment

Required string length: 36
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"95b11417-f18f-457f-8804-68e361f9164f"

​
walletAddress
string
required

Public key (address) of the wallet

Maximum string length: 255
Pattern: ^(?=\S)[\p{L}\p{N}a-zA-Z _.,:!?&%@\/+\-'|]+(?<=\S)$
Example:

"An example name"

Response

WaaS wallet fetched successfully

​
id
string
required
Required string length: 36
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"95b11417-f18f-457f-8804-68e361f9164f"

​
projectEnvironmentId
string
required
Required string length: 36
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"95b11417-f18f-457f-8804-68e361f9164f"

​
verifiedCredentials
object[]
required
​
lastVerifiedCredentialId
string
Required string length: 36
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"95b11417-f18f-457f-8804-68e361f9164f"

​
sessionId
string
Required string length: 36
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"95b11417-f18f-457f-8804-68e361f9164f"

​
alias
string | null
Maximum string length: 255
Pattern: ^$|^(?=\S)[\p{L}\p{N} _.,:!?&%@\/+-]+(?<=\S)$
Example:

"An example name"

​
country
string | null

Standard ISO 3166-1 alpha-2 two-letter country code

Maximum string length: 255
Pattern: ^[A-Z]{2}$
Example:

"US"

​
email
string<email> | null
Maximum string length: 255
​
firstName
string | null
Maximum string length: 255
Pattern: ^$|^(?=\S)[\p{L}\p{N} _.,:!?&%@\/+-]+(?<=\S)$
Example:

"An example name"

​
jobTitle
string | null
Maximum string length: 255
Pattern: ^$|^(?=\S)[\p{L}\p{N} _.,:!?&%@\/+-]+(?<=\S)$
Example:

"An example name"

​
lastName
string | null
Maximum string length: 255
Pattern: ^$|^(?=\S)[\p{L}\p{N} _.,:!?&%@\/+-]+(?<=\S)$
Example:

"An example name"

​
phoneNumber
string | null
Maximum string length: 255
​
policiesConsent
boolean | null
​
tShirtSize
string | null
Maximum string length: 255
Pattern: ^$|^(?=\S)[\p{L}\p{N} _.,:!?&%@\/+-]+(?<=\S)$
Example:

"An example name"

​
team
string | null
Maximum string length: 255
Pattern: ^$|^(?=\S)[\p{L}\p{N} _.,:!?&%@\/+-]+(?<=\S)$
Example:

"An example name"

​
username
string | null
Maximum string length: 255
Pattern: ^$|^(?=\S)[\p{L}\p{N} _.,:!?&%@\/+-]+(?<=\S)$
Example:

"An example name"

​
firstVisit
string<date-time>
​
lastVisit
string<date-time>
​
newUser
boolean
​
metadata
object
​
mfaBackupCodeAcknowledgement
enum<string> | null
Available options:
pending,
complete
​
btcWallet
string | null
​
kdaWallet
string | null
​
ltcWallet
string | null
​
ckbWallet
string | null
​
kasWallet
string | null
​
dogeWallet
string | null
​
emailNotification
boolean | null
​
discordNotification
boolean | null
​
newsletterNotification
boolean | null
​
lists
string[]

Access lists evaluated by Dynamic when considering access for the user.

​
scope
string

A whitespace-separate list of permissions associated with the JWT token issued. This conforms to the JWT standard for scope claims: https://datatracker.ietf.org/doc/html/rfc8693#section-4.2

Example:

"superuser marketing operations"

​
missingFields
object[]