Get Linked External Wallet - Crossmint Docs

Get Linked External Wallet

curl --request GET \
  --url https://staging.crossmint.com/api/2025-06-09/users/{userLocator}/linked-wallets/{address} \
  --header 'X-API-KEY: <x-api-key>'

import requests

url = "https://staging.crossmint.com/api/2025-06-09/users/{userLocator}/linked-wallets/{address}"

headers = {"X-API-KEY": "<x-api-key>"}

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

print(response.text)

const options = {method: 'GET', headers: {'X-API-KEY': '<x-api-key>'}};

fetch('https://staging.crossmint.com/api/2025-06-09/users/{userLocator}/linked-wallets/{address}', 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://staging.crossmint.com/api/2025-06-09/users/{userLocator}/linked-wallets/{address}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <x-api-key>"
  ],
]);

$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://staging.crossmint.com/api/2025-06-09/users/{userLocator}/linked-wallets/{address}"

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

	req.Header.Add("X-API-KEY", "<x-api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://staging.crossmint.com/api/2025-06-09/users/{userLocator}/linked-wallets/{address}")

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

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<x-api-key>'

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

{
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "chain": "ethereum",
  "ownership": {
    "verified": true
  },
  "type": "external-wallet"
}

GET

/

2025-06-09

/

users

/

{userLocator}

/

linked-wallets

/

{address}

Get Linked External Wallet

curl --request GET \
  --url https://staging.crossmint.com/api/2025-06-09/users/{userLocator}/linked-wallets/{address} \
  --header 'X-API-KEY: <x-api-key>'

import requests

url = "https://staging.crossmint.com/api/2025-06-09/users/{userLocator}/linked-wallets/{address}"

headers = {"X-API-KEY": "<x-api-key>"}

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

print(response.text)

const options = {method: 'GET', headers: {'X-API-KEY': '<x-api-key>'}};

fetch('https://staging.crossmint.com/api/2025-06-09/users/{userLocator}/linked-wallets/{address}', 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://staging.crossmint.com/api/2025-06-09/users/{userLocator}/linked-wallets/{address}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <x-api-key>"
  ],
]);

$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://staging.crossmint.com/api/2025-06-09/users/{userLocator}/linked-wallets/{address}"

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

	req.Header.Add("X-API-KEY", "<x-api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://staging.crossmint.com/api/2025-06-09/users/{userLocator}/linked-wallets/{address}")

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

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<x-api-key>'

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

{
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "chain": "ethereum",
  "ownership": {
    "verified": true
  },
  "type": "external-wallet"
}

Headers

X-API-KEY

string

required

API key required for authentication

Path Parameters

userLocator

string

required

A user locator can be of the format:

email:<email>
userId:<userId>
phoneNumber:<phoneNumber>
twitter:<handle>
x:<handle>

address

string

required

Response

Linked wallet found

address

string

required

The wallet address

Example:

"0x1234567890abcdef1234567890abcdef12345678"

chain

enum<string>

required

The blockchain of the wallet

Available options:

abstract,

abstract-testnet,

apechain,

aptos,

arbitrum,

arbitrum-sepolia,

arbitrumnova,

arc-testnet,

astar-zkevm,

avalanche,

avalanche-fuji,

base,

base-goerli,

base-sepolia,

bsc,

bsc-testnet,

chiliz,

chiliz-spicy-testnet,

coti,

coti-testnet,

crossmint-private-testnet-ethereum,

crossmint-private-testnet-polygon,

curtis,

ethereum,

ethereum-goerli,

ethereum-sepolia,

flow,

flow-testnet,

hedera,

hedera-testnet,

hypersonic-testnet,

lightlink,

lightlink-pegasus,

mantle,

mantle-sepolia,

mode,

mode-sepolia,

optimism,

optimism-goerli,

optimism-sepolia,

plume,

plume-testnet,

polygon,

polygon-amoy,

polygon-mumbai,

rari,

rari-testnet,

robinhood-chain,

robinhood-chain-testnet,

scroll,

scroll-sepolia,

sei-atlantic-2-testnet,

sei-pacific-1,

shape,

shape-sepolia,

skale-nebula,

skale-nebula-testnet,

solana,

soneium,

soneium-minato-testnet,

space,

space-testnet,

stellar,

story,

story-testnet,

sui,

tempo,

tempo-testnet,

u2u-nebulas,

u2u-solaris,

verify-testnet,

viction,

viction-testnet,

world-chain,

world-chain-sepolia,

xai,

xai-sepolia-testnet,

xion,

zenchain-testnet,

zkatana,

zkyoto,

zora,

zora-goerli,

zora-sepolia

Example:

"ethereum"

ownership

object

required

Ownership verification status of the wallet

Option 1
Option 2

Show child attributes

type

enum<string>

required

The type of linked wallet

Available options:

external-wallet

Example:

"external-wallet"