GET

Get enterprise user signing key

Get the signing key for an enterprise user. The signing key is used to sign arbitrary messages, which other enterprise users can verify. The caller of this API must have view permissions on the enterprise.

Path Params

enterpriseId string required

at least 1 characters · matches ^[0-9a-f]{32}$
userId string required

at least 1 characters · matches ^([0-9a-f]{32}|me)$

Responses

200

Response Body

object

userId string required

matches ^[0-9a-f]{32}$
userEmail string email required
derivedPubkey string required

The derived public key of the user.
derivationPath string nullable

The derivation path used to derive derivedPubkey. Returned only if you're fetching your own signing key.
ecdhKeychain string nullable

The bip32 public key that you can use to fetch a v1 keychain. Returned only if you're fetching your own signing key.

400

Bad Request

Response Body

ONE OF

name string

Error code
context map of objects required

Properties that apply to a specific error name
context object
- <key> object
error string required

Human-readable error message
requestId string required

Client request id

name string enum required

InvalidEnterpriseId
context object required
context object
- id string required
  
  matches ^[0-9a-f]{32}$
error string required

Human-readable error message
requestId string required

Client request id

404

Not Found

Response Body

object

name string

Error code
context map of objects required

Properties that apply to a specific error name
context object
- <key> object
error string required

Human-readable error message
requestId string required

Client request id

curl --request GET \ --url 'https://app.bitgo-test.com/api/v2/enterprise/enterpriseId/user/userId/signingkey' \ --header 'accept: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

const url = 'https://app.bitgo-test.com/api/v2/enterprise/enterpriseId/user/userId/signingkey'; const options = {method: 'GET', headers: {accept: 'application/json', 'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}}; fetch(url, options) .then(res => res.json()) .then(json => console.log(json)) .catch(err => console.error(err));

require 'uri' require 'net/http' url = URI("https://app.bitgo-test.com/api/v2/enterprise/enterpriseId/user/userId/signingkey") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["accept"] = 'application/json' request["Authorization"] = 'Bearer YOUR_ACCESS_TOKEN' response = http.request(request) puts response.read_body

<?php require_once('vendor/autoload.php'); $client = new \GuzzleHttp\Client(); $response = $client->request('GET', 'https://app.bitgo-test.com/api/v2/enterprise/enterpriseId/user/userId/signingkey', [ 'headers' => [ 'accept' => 'application/json', 'Authorization' => 'Bearer YOUR_ACCESS_TOKEN', ], ]); echo $response->getBody();

import requests url = "https://app.bitgo-test.com/api/v2/enterprise/enterpriseId/user/userId/signingkey" headers = { "accept": "application/json", "Authorization": "Bearer YOUR_ACCESS_TOKEN" } response = requests.get(url, headers=headers) print(response.text)

{ "userId": "59cd72485007a239fb00282ed480da1f", "userEmail": "user@email.com", "derivedPubkey": "0205f47704d137205ba32560e01ed182428c758760d9a05ae58cf2f66069f5d717", "derivationPath": "m/999999/51550848/191290384", "ecdhKeychain": "xpub661MyMwAqRbcFm7W87Qcns2ybFoSHsHEkGzNQj1KhPeLNUtV7KKiQvtLVLwPpWFaohqXrCBqCit9sM6G5kmtZHaJYSvMC65ge9HATFShe1S" }