ReferenceAPI ReferenceWallet

Lookup wallet anchors

POST/wallets/{id}/anchors/\!lookup●Search for anchors linked to a wallet using advanced filters.

Searches anchors linked to this wallet using filters provided in the request body. If the wallet has a bridge assigned with the anchors trait, the lookup is forwarded to the bridge.

POST
/wallets/{id}/anchors/\!lookup

Usage Examples

curl -X POST "http://localhost:3000/v2/wallets/string/anchors/\!lookup" \  -H "x-ledger: <YOUR LEDGER HANDLE>" \  -H "Content-Type: application/json" \  -d '{    "hash": "f4cf1f02ebec6637d14ece86dc4e00819fb23d9eea47d0a67403757f12746967",    "data": {      "wallet": "tesla-bank-wallet"    },    "meta": {      "proofs": [        {          "method": "ed25519-v2",          "digest": "be24c2b7b68c42b390b6e252e00275e0dbcd5df1704deeec9b1020c0f95255a2",          "public": "dsZvr0rEw9sIffHlv1VP65x1NB8GeXezIv6HONk1SIk=",          "result": "IejjxcKL4iwHkRg71OBg3NXq2PY7V4bLBQAf5hAMBLwBFUjEhtlP2HAd2NkYBp3UkegY6qmLoQ6xy1KVCLw4Bg==",          "custom": {            "moment": "2025-04-05T14:30:00.530Z"          }        }      ]    }  }'
{
  "hash": "349215864c5972a1b48cdc791f575d611d08bb9829dfe177d28ab33f38e12f28",
  "data": [
    {
      "luid": "$anc.-01xK2cTuV3dS4xY3",
      "hash": "b907d26c8dc13a9f147ddf61412ec0690befbe5389b491fb8a132b2e7560df87",
      "data": {
        "handle": "tel:+1234567890",
        "wallet": "tesla-bank-wallet",
        "target": "svgs:1001001234@tesla-bank.com",
        "symbol": "usd",
        "custom": {
          "name": "John Doe",
          "entityType": "individual"
        }
      },
      "meta": {
        "moment": "2025-04-05T14:30:00.520Z",
        "proofs": [
          {
            "signer": "system",
            "method": "ed25519-v2",
            "digest": "6ab5772cc1cf45af4c943bcbd49704b1a27f2cff20d05c8946ec1949bdbcf041",
            "public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
            "result": "XdDctHONO7mPP4rNK47jff4kfT452fjd2cF+Z3pqImVlyW0XlDGK/SPfVR4m1rDjsVml8MQqYVAwFi9C/PHwBQ==",
            "custom": {
              "luid": "$anc.-01xK2cTuV3dS4xY3",
              "moment": "2025-04-05T14:30:00.520Z"
            }
          }
        ]
      }
    }
  ],
  "meta": {
    "proofs": [
      {
        "signer": "system",
        "method": "ed25519-v2",
        "digest": "99cc95b4a6e80ef5e3f7c838042ef9366118f8fa5179e5b4277f5cd1cc0c8397",
        "public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
        "result": "XVF5wbVsfoFMiuNC8oPbEoSJk5jae1v5SFYoNXvELGFX/8Bm6HCT60BSQtkX3kO1QMoItUx/NEPL0ARYlF6JDQ==",
        "custom": {
          "moment": "2025-04-05T14:30:00.100Z"
        }
      }
    ]
  }
}
{
  "hash": "b7eb7ccf5ffc126951e13e29a8dcfdaf95db859715d4edfc2d16f59a79d4cd58",
  "data": {
    "reason": "auth.unauthorized",
    "detail": "Invalid token."
  },
  "meta": {
    "proofs": [
      {
        "signer": "system",
        "method": "ed25519-v2",
        "digest": "3acece870c4118bfe4223118e4d2f3cfd5b8947a7093785b66d49aa57fa2890a",
        "public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
        "result": "gnK63DqqWDY/UXvnZHixDKPKS6tfeGHgdARylnPiJLwQGyYxuD97TYbSg2wrzsf/bDrHwQYZaf8Gu5ryYP0UAA==",
        "custom": {
          "moment": "2025-04-05T14:30:00.000Z"
        }
      }
    ]
  }
}
{
  "hash": "9ec02726b50650add8acfd124c6defeb978a9ac252a5de888f9493ddc701e927",
  "data": {
    "reason": "auth.forbidden",
    "detail": "Request is not authorized"
  },
  "meta": {
    "proofs": [
      {
        "signer": "system",
        "method": "ed25519-v2",
        "digest": "4f8cbdc38d73348de0c31805c783c84a0fecc6be736d7e187004ba68cd00e675",
        "public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
        "result": "P3hRnveehtuobb4AIO56XBmiduvmYJbpdmOHltG/IifBEH7QSWdv/0pqled4SO9x1Ne3oXuWxJy40DzMvx1MBA==",
        "custom": {
          "moment": "2025-04-05T14:30:00.000Z"
        }
      }
    ]
  }
}
{
  "hash": "d6c59a6df7165fa4a75159799ca5f5e26e544cbb8769eced3d35d8021f6f7935",
  "data": {
    "reason": "record.not-found",
    "detail": "Signer not found"
  },
  "meta": {
    "proofs": [
      {
        "signer": "system",
        "method": "ed25519-v2",
        "digest": "78cf86f34aefcf9da6ed4167a38aac0a2739f68f7bafb1d3e033c01ed1b6cdf1",
        "public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
        "result": "9Ledk+/iAAtj+uLjGe2afq4kID7n8UQD6UpRpLBCujxFjxddq0uZ2tnYRTAXmYdHDkbF0uXqtNM9qO3xhEtpAA==",
        "custom": {
          "moment": "2025-04-05T14:30:00.000Z"
        }
      }
    ]
  }
}

{
  "hash": "1c084e8dcfb9bb84bc8ea96e9e137b149a34b2bbd85f8e60b4263f5aba980476",
  "data": {
    "custom": {
      "errors": [
        {
          "instancePath": "/handle",
          "schemaPath": "#/properties/handle/pattern",
          "keyword": "pattern",
          "params": {
            "pattern": "^[a-zA-Z0-9_\\-+.]+$"
          },
          "message": "must match pattern \"^[a-zA-Z0-9_\\-+.]+$\""
        }
      ]
    },
    "reason": "record.schema-invalid",
    "detail": "Schema validator error: data.handle must match pattern \"^[a-zA-Z0-9_\\-+.]+$\""
  },
  "meta": {
    "proofs": [
      {
        "signer": "system",
        "method": "ed25519-v2",
        "digest": "7a5febb431719b6f43d7e88e79211308e16ac651b71b339276373fdb4e7c3760",
        "public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
        "result": "2/1zYw4AaIzsIHfOIC6V/CHw6owbjYHt48cwmFOig0ibeT0IbojLmj1RCRi8W00ka0udPa9WsacWDd7ObMY8CA==",
        "custom": {
          "moment": "2025-04-05T14:30:00.000Z"
        }
      }
    ]
  }
}

{
  "hash": "93a5f4d97a42c2df97f827c58ff7768d02568c15aca931e22b81fa3160ba0df3",
  "data": {
    "reason": "api.unexpected-error",
    "detail": "An unexpected error occurred"
  },
  "meta": {
    "proofs": [
      {
        "signer": "system",
        "method": "ed25519-v2",
        "digest": "efaf5360143b586917d9636779ad6e08571c5b06909a20dd0f5eba4bf3be7eae",
        "public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
        "result": "hERh6Aecj59iR+Fb25OQsHJScOi4t8EiffKSfjlMQdjHMccTnfDlgZFdaJzXzUtpSwy/NHq0l+7ydh3HSWCoAg==",
        "custom": {
          "moment": "2025-04-05T14:30:00.000Z"
        }
      }
    ]
  }
}

Path Parameters

id*|

The unique identifier of the wallet record - it is luid or handle (address).

Header Parameters

x-ledger?|

The unique identifier of ledger in context for multi tenant requests.

Request Body

application/json

Anchor lookup body

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

List wallet anchors GET

Returns anchors linked to this wallet. If the wallet has a bridge assigned with the `anchors` trait, the query is forwarded to the bridge instead of the local database.

List wallet domains GET

Returns the domains associated with this wallet. If the wallet has a bridge assigned with the `domains` trait, the query is forwarded to the bridge instead of the local database.