Get a WAAS wallet by address

Fetches a single WaaS wallet and returns it with the same payload structure as the users endpoint. This endpoint returns user information along with verified credentials filtered to only include the specified WaaS wallet.

GET /sdk/{environmentId}/waas/byWalletAddress/{walletAddress}

Get a WAAS wallet by address

cURL

curl --request GET \
  --url https://app.dynamicauth.com/api/v0/sdk/{environmentId}/waas/byWalletAddress/{walletAddress} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.dynamicauth.com/api/v0/sdk/{environmentId}/waas/byWalletAddress/{walletAddress}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.dynamicauth.com/api/v0/sdk/{environmentId}/waas/byWalletAddress/{walletAddress}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.dynamicauth.com/api/v0/sdk/{environmentId}/waas/byWalletAddress/{walletAddress}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.dynamicauth.com/api/v0/sdk/{environmentId}/waas/byWalletAddress/{walletAddress}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://app.dynamicauth.com/api/v0/sdk/{environmentId}/waas/byWalletAddress/{walletAddress}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.dynamicauth.com/api/v0/sdk/{environmentId}/waas/byWalletAddress/{walletAddress}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

200

{
  "id": "95b11417-f18f-457f-8804-68e361f9164f",
  "projectEnvironmentId": "95b11417-f18f-457f-8804-68e361f9164f",
  "verifiedCredentials": [
    {
      "id": "95b11417-f18f-457f-8804-68e361f9164f",
      "signInEnabled": true,
      "address": "0xbF394748301603f18d953C90F0b087CBEC0E1834",
      "chain": "<string>",
      "refId": "95b11417-f18f-457f-8804-68e361f9164f",
      "signerRefId": "95b11417-f18f-457f-8804-68e361f9164f",
      "email": "[e-mail]",
      "name_service": {
        "avatar": "<string>",
        "name": "<string>"
      },
      "public_identifier": "<string>",
      "wallet_name": "<string>",
      "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
      },
      "business_account_properties": {
        "businessAccountId": "95b11417-f18f-457f-8804-68e361f9164f",
        "businessAccountCreatedAt": "2023-11-07T05:31:56Z",
        "businessAccountSignerId": "95b11417-f18f-457f-8804-68e361f9164f",
        "businessAccountName": "<string>",
        "businessAccountExternalRef": "<string>"
      },
      "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>",
          "publicKey": "<string>",
          "network": "<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": "[e-mail]",
  "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": {},
  "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,
      "validationRules": {
        "unique": true,
        "regex": "^0x",
        "validOptions": [
          {
            "label": "small"
          },
          {
            "label": "medium"
          },
          {
            "label": "large"
          }
        ],
        "checkboxText": "Agree to the terms and conditions"
      },
      "label": "<string>",
      "position": 123
    }
  ]
}

{
  "error": "No jwt provided!"
}

{
  "error": "Access Forbidden"
}

{
  "error": "Not Found",
  "code": "not_found"
}

{
  "error": "Internal Server Error"
}

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

200

application/json

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

List of verified credentials (wallets, emails, social accounts) linked to the user

Show child attributes

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

Primary email address of the user

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

Phone number of the user

Maximum string length: 255

policiesConsent · boolean | null

Whether the user has accepted the terms of service and privacy policy

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>

ISO 8601 timestamp of when the user first visited

lastVisit · string<date-time>

ISO 8601 timestamp of when the user last visited

newUser · boolean

Whether this is a newly created user

metadata · object

Arbitrary key-value metadata associated with the user

mfaBackupCodeAcknowledgement · enum<string> | null

Available options: pending, complete

btcWallet · string | null

Bitcoin wallet address of the user

kdaWallet · string | null

Kadena wallet address of the user

ltcWallet · string | null

Litecoin wallet address of the user

ckbWallet · string | null

Nervos CKB wallet address of the user

kasWallet · string | null

Kaspa wallet address of the user

dogeWallet · string | null

Dogecoin wallet address of the user

emailNotification · boolean | null

Whether the user has opted in to email notifications

discordNotification · boolean | null

Whether the user has opted in to Discord notifications

newsletterNotification · boolean | null

Whether the user has opted in to newsletter notifications

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[]

List of required user fields that have not yet been provided

Show child attributes