Get Wallet

The Get Wallet endpoint allows you to retrieve details for a specific wallet within your Signchain Vault.

Endpoint

GET/api/v1/vaults/:vaultId/wallets/:address

Test Endpoint

Request Headers

  • Authorization: Bearer token for authentication. Should be Bearer <Your-API-Key>.
  • Content-Type: Must be application/json.
  • Accept: Must be application/json.

Request Parameters

  • vaultId - The unique identifier of the vault where the wallet is stored.
  • address - The Ethereum address of the wallet to retrieve.

Example Request

curl -X GET https://signchain.net/api/v1/vault/{vaultId}/wallets/{address} \
     -H "Authorization: Bearer <API_KEY>"

Example Response

{
  "success": Request_Success_Status,
  "data": {
    "id": "<Your-Wallet-ID>",
    "account": "<Your-Account-ID>",
    "vault": "<Your-Vault-ID>",
    "name": "<Your-Wallets-Name>",
    "address": "<Your-Unique-Wallet-Address>",
    "created": "<Current-Date-ISO>",
    "updated": "<Current-Date-ISO>",
    "expires": "<Wallet-Expiry-Date-ISO>"
  },
  "error": "<Error-Message>"
}

Response

The response includes the wallet object with the following fields:

  • success: A boolean true or false determining whether the get request was successful or not. If the get request was not successful, this value will be false and the error field will be populated.
  • error: A string error message, only sent if the success parameter is false.
  • id (string) - The unique identifier of the wallet within the vault.
  • account (string) - Your Signchain account ID.
  • vault (string) - Your vault's unique identifier.
  • name (string) - The descriptive name assigned to the wallet.
  • address (string) - The unique Ethereum address of the wallet.
  • created (string, ISO 8601 format) - The date and time when the wallet was created.
  • updated (string, ISO 8601 format) - The last updated date of the wallet, which will be when it was created.
  • expires (optional, string, ISO 8601 format) - If the wallet is set to expire, then this field will be included and is the date the wallet is marked for expiry and deletion, including all private key data associated with the wallet.

This endpoint is useful for quickly retrieving details for any wallet within your vault by specifying its unique address.