Verify endpoints

Get integrations supported for wallet verification

Get the wallets and networks that can verify wallet ownership.

Use this list to decide which integrationId and verifyWalletOptions.networkId to send when creating a link token for verification. Every pair returned with isSupported: true is accepted by POST /api/v1/linktoken when the request has verifyWalletOptions and no transferOptions; other pairs are rejected or have no way to verify in Link. The list does not apply the wallets your Link configuration includes or excludes.

supportedDevices lists where Link can complete the verification: android and ios for mobile apps and mobile browsers, web for desktop browsers. Ledger and Trezor list mobile devices too: on a phone, Link hands the signing step to a desktop browser.

Filter with integrationId (one wallet’s networks) or networkId (every wallet on one network). Pass both to check one pair: the response then always holds that pair, with isSupported and, when it cannot be verified, unsupportedReason. Lists only hold supported pairs. An id that is not a self-custody wallet or a network Mesh knows returns 400 with errorType invalidIntegrationId or invalidNetworkId; when both are wrong, the message names both and errorType is invalidIntegrationId.

This list is for verification only. GET /api/v1/transfers/managed/integrations lists transfer support, which differs.

GET

api

wallets

verify

integrations

Get integrations supported for wallet verification

curl --request GET \
  --url https://integration-api.meshconnect.com/api/v1/wallets/verify/integrations \
  --header 'X-Client-Id: <api-key>' \
  --header 'X-Client-Secret: <api-key>'

import requests

url = "https://integration-api.meshconnect.com/api/v1/wallets/verify/integrations"

headers = {
    "X-Client-Secret": "<api-key>",
    "X-Client-Id": "<api-key>"
}

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

print(response.text)

const options = {
  method: 'GET',
  headers: {'X-Client-Secret': '<api-key>', 'X-Client-Id': '<api-key>'}
};

fetch('https://integration-api.meshconnect.com/api/v1/wallets/verify/integrations', 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://integration-api.meshconnect.com/api/v1/wallets/verify/integrations",
  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-Client-Id: <api-key>",
    "X-Client-Secret: <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://integration-api.meshconnect.com/api/v1/wallets/verify/integrations"

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

	req.Header.Add("X-Client-Secret", "<api-key>")
	req.Header.Add("X-Client-Id", "<api-key>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://integration-api.meshconnect.com/api/v1/wallets/verify/integrations")
  .header("X-Client-Secret", "<api-key>")
  .header("X-Client-Id", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://integration-api.meshconnect.com/api/v1/wallets/verify/integrations")

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

request = Net::HTTP::Get.new(url)
request["X-Client-Secret"] = '<api-key>'
request["X-Client-Id"] = '<api-key>'

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

{
  "content": {
    "integrations": [
      {
        "id": "56c7bfb1-4655-4581-9cb6-4cefd87b299c",
        "type": "deFiWallet",
        "name": "Ledger",
        "networks": [
          {
            "id": "03dee5da-7398-428f-9ec2-ab41bcb271da",
            "name": "Bitcoin",
            "chainId": "0",
            "supportedDevices": [
              "android",
              "ios",
              "web"
            ],
            "isSupported": true,
            "unsupportedReason": null
          }
        ]
      },
      {
        "id": "34aeb688-decb-485f-9d80-b66466783394",
        "type": "deFiWallet",
        "name": "MetaMask",
        "networks": [
          {
            "id": "03dee5da-7398-428f-9ec2-ab41bcb271da",
            "name": "Bitcoin",
            "chainId": "0",
            "supportedDevices": [
              "web"
            ],
            "isSupported": true,
            "unsupportedReason": null
          },
          {
            "id": "e3c7fdd8-b1fc-4e51-85ae-bb276e075611",
            "name": "Ethereum",
            "chainId": "1",
            "supportedDevices": [
              "android",
              "ios",
              "web"
            ],
            "isSupported": true,
            "unsupportedReason": null
          }
        ]
      }
    ]
  },
  "status": "ok",
  "message": "",
  "errorHash": "e228dbf2",
  "teamCode": "P4",
  "errorType": ""
}

Authorizations

X-Client-Secret

string

header

required

Contact Mesh to get client Secret

X-Client-Id

string

header

required

Contact Mesh to get client Id

Query Parameters

IntegrationId

string

Only return this self-custody wallet. Use the same id you send as integrationId when creating a link token.

NetworkId

string

Only return this network. Use the same id you send as verifyWalletOptions.networkId when creating a link token. With integrationId too, the response always holds that one pair, with isSupported and, when it cannot be verified, unsupportedReason.

Response

Integrations obtained.

status

enum<string>

Available options:

ok,

serverFailure,

permissionDenied,

badRequest,

notFound,

conflict,

tooManyRequest,

locked,

unavailableForLegalReasons,

serviceUnavailable

message

string | null

A message generated by the API

displayMessage

string | null

User-friendly display message that can be presented to the end user

errorHash

string | null

read-only

An error grouping hash from string components and caller information. Used by bugsnag on FE for correct error grouping

teamCode

string | null

read-only

Opaque team code for error routing. Resolved from exception origin or caller file path via CODEOWNERS. Format: 2-character code (e.g., "7K", "M2"). Use for alerting/routing, not display.

errorType

string | null

Strictly-typed error type that is explaining the reason of an unsuccessful status of the operation. All possible error types are available in the documentation.

errorData

unknown

content

object | null

Show child attributes

⌘I

Get integrations supported for wallet verification

curl --request GET \
  --url https://integration-api.meshconnect.com/api/v1/wallets/verify/integrations \
  --header 'X-Client-Id: <api-key>' \
  --header 'X-Client-Secret: <api-key>'

import requests

url = "https://integration-api.meshconnect.com/api/v1/wallets/verify/integrations"

headers = {
    "X-Client-Secret": "<api-key>",
    "X-Client-Id": "<api-key>"
}

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

print(response.text)

const options = {
  method: 'GET',
  headers: {'X-Client-Secret': '<api-key>', 'X-Client-Id': '<api-key>'}
};

fetch('https://integration-api.meshconnect.com/api/v1/wallets/verify/integrations', 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://integration-api.meshconnect.com/api/v1/wallets/verify/integrations",
  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-Client-Id: <api-key>",
    "X-Client-Secret: <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://integration-api.meshconnect.com/api/v1/wallets/verify/integrations"

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

	req.Header.Add("X-Client-Secret", "<api-key>")
	req.Header.Add("X-Client-Id", "<api-key>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://integration-api.meshconnect.com/api/v1/wallets/verify/integrations")
  .header("X-Client-Secret", "<api-key>")
  .header("X-Client-Id", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://integration-api.meshconnect.com/api/v1/wallets/verify/integrations")

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

request = Net::HTTP::Get.new(url)
request["X-Client-Secret"] = '<api-key>'
request["X-Client-Id"] = '<api-key>'

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

{
  "content": {
    "integrations": [
      {
        "id": "56c7bfb1-4655-4581-9cb6-4cefd87b299c",
        "type": "deFiWallet",
        "name": "Ledger",
        "networks": [
          {
            "id": "03dee5da-7398-428f-9ec2-ab41bcb271da",
            "name": "Bitcoin",
            "chainId": "0",
            "supportedDevices": [
              "android",
              "ios",
              "web"
            ],
            "isSupported": true,
            "unsupportedReason": null
          }
        ]
      },
      {
        "id": "34aeb688-decb-485f-9d80-b66466783394",
        "type": "deFiWallet",
        "name": "MetaMask",
        "networks": [
          {
            "id": "03dee5da-7398-428f-9ec2-ab41bcb271da",
            "name": "Bitcoin",
            "chainId": "0",
            "supportedDevices": [
              "web"
            ],
            "isSupported": true,
            "unsupportedReason": null
          },
          {
            "id": "e3c7fdd8-b1fc-4e51-85ae-bb276e075611",
            "name": "Ethereum",
            "chainId": "1",
            "supportedDevices": [
              "android",
              "ios",
              "web"
            ],
            "isSupported": true,
            "unsupportedReason": null
          }
        ]
      }
    ]
  },
  "status": "ok",
  "message": "",
  "errorHash": "e228dbf2",
  "teamCode": "P4",
  "errorType": ""
}

Guides

API Reference

Get integrations supported for wallet verification

Authorizations

Query Parameters

Response