List Private Keys

List all Private Keys within an Organization

POST

/

public

/

v1

/

query

/

list_private_keys

Authorizations

API Key

X-Stamp

string

header

required

Body

organizationId · string · required

Unique identifier for a given Organization.

Response

A successful response returns the following fields:

privateKeys · array · required

A list of Private Keys.

Show privateKeys details

privateKeys.privateKeyId

string

required

Unique identifier for a given Private Key.

privateKeys.publicKey

string

required

The public component of a cryptographic key pair used to sign messages and transactions.

privateKeys.privateKeyName

string

required

Human-readable name for a Private Key.

privateKeys.curve

enum

required

curve field

Enum options: CURVE_SECP256K1, CURVE_ED25519

privateKeys.addresses

array

required

Derived cryptocurrency addresses for a given Private Key.

Show addresses details

privateKeys.addresses.format

enum

format field

Enum options: ADDRESS_FORMAT_UNCOMPRESSED, ADDRESS_FORMAT_COMPRESSED, ADDRESS_FORMAT_ETHEREUM, ADDRESS_FORMAT_SOLANA, ADDRESS_FORMAT_COSMOS, ADDRESS_FORMAT_TRON, ADDRESS_FORMAT_SUI, ADDRESS_FORMAT_APTOS, ADDRESS_FORMAT_BITCOIN_MAINNET_P2PKH, ADDRESS_FORMAT_BITCOIN_MAINNET_P2SH, ADDRESS_FORMAT_BITCOIN_MAINNET_P2WPKH, ADDRESS_FORMAT_BITCOIN_MAINNET_P2WSH, ADDRESS_FORMAT_BITCOIN_MAINNET_P2TR, ADDRESS_FORMAT_BITCOIN_TESTNET_P2PKH, ADDRESS_FORMAT_BITCOIN_TESTNET_P2SH, ADDRESS_FORMAT_BITCOIN_TESTNET_P2WPKH, ADDRESS_FORMAT_BITCOIN_TESTNET_P2WSH, ADDRESS_FORMAT_BITCOIN_TESTNET_P2TR, ADDRESS_FORMAT_BITCOIN_SIGNET_P2PKH, ADDRESS_FORMAT_BITCOIN_SIGNET_P2SH, ADDRESS_FORMAT_BITCOIN_SIGNET_P2WPKH, ADDRESS_FORMAT_BITCOIN_SIGNET_P2WSH, ADDRESS_FORMAT_BITCOIN_SIGNET_P2TR, ADDRESS_FORMAT_BITCOIN_REGTEST_P2PKH, ADDRESS_FORMAT_BITCOIN_REGTEST_P2SH, ADDRESS_FORMAT_BITCOIN_REGTEST_P2WPKH, ADDRESS_FORMAT_BITCOIN_REGTEST_P2WSH, ADDRESS_FORMAT_BITCOIN_REGTEST_P2TR, ADDRESS_FORMAT_SEI, ADDRESS_FORMAT_XLM, ADDRESS_FORMAT_DOGE_MAINNET, ADDRESS_FORMAT_DOGE_TESTNET, ADDRESS_FORMAT_TON_V3R2, ADDRESS_FORMAT_TON_V4R2, ADDRESS_FORMAT_XRP

privateKeys.addresses.address

string

address field

privateKeys.privateKeyTags

array

required

A list of Private Key Tag IDs.

Show privateKeyTags details

privateKeys.privateKeyTags.item

string

required

item field

privateKeys.createdAt

object

required

createdAt field

Show createdAt details

privateKeys.createdAt.seconds

string

required

seconds field

privateKeys.createdAt.nanos

string

required

nanos field

privateKeys.updatedAt

object

required

updatedAt field

Show updatedAt details

privateKeys.updatedAt.seconds

string

required

seconds field

privateKeys.updatedAt.nanos

string

required

nanos field

privateKeys.exported

boolean

required

True when a given Private Key is exported, false otherwise.

privateKeys.imported

boolean

required

True when a given Private Key is imported, false otherwise.

cURL

curl --request POST \
  --url https://api.turnkey.com/public/v1/query/list_private_keys \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header "X-Stamp: <YOUR_API_KEY.YOUR_API_SECRET>" \
  --data '{
    "organizationId": "<string>"
}'

200

{
  "activity": {
    "id": "<activity-id>",
    "status": "ACTIVITY_STATUS_COMPLETED",
    "type": "ACTIVITY_TYPE_UNKNOWN_V1",
    "organizationId": "<organization-id>",
    "timestampMs": "<timestamp> (e.g. 1746736509954)",
    "result": {
      "privateKeys": [
        {
          "privateKeyId": "<string>",
          "publicKey": "<string>",
          "privateKeyName": "<string>",
          "curve": "<CURVE_SECP256K1>",
          "addresses": [
            {
              "format": "<ADDRESS_FORMAT_UNCOMPRESSED>",
              "address": "<string>"
            }
          ],
          "privateKeyTags": [
            "<string_element>"
          ],
          "createdAt": {
            "seconds": "<string>",
            "nanos": "<string>"
          },
          "updatedAt": {
            "seconds": "<string>",
            "nanos": "<string>"
          },
          "exported": true,
          "imported": true
        }
      ]
    }
  }
}