Ctrl+K

List Go Account

Overview

BitGo provides a directory for Go Accounts for you to list yourself and find others. Each enterprise in the directory has 1 listing for itself. Each enterprise listing can have multiple entries. For example, your Go Account is an entry in your listing.

Prerequisites

Get Started

1. List your Enterprise

List your enterprise in the public directory so that other enterprises can find you and add you as a counterparty.

Endpoint: Create enterprise listing

  • cURL
1
2
3
4
5
6
7
8
export ACCESS_TOKEN="<YOUR_ACCESS_TOKEN>"
export DESCRIPTION="<YOUR_PUBLIC_DESCRIPTION>"

curl -X POST \
  https://app.bitgo-test.com/api/address-book/v1/listing/global \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -d '{"description": "'"$DESCRIPTION"'"}'

Step Result

You Enterprise is now discoverable in the public directory.

  • JSON
1
2
3
4
5
6
7
8
9
{
  "id": "string",
  "enterpriseId": "string",
  "description": "string",
  "name": "string",
  "owner": "string",
  "createdAt": "string",
  "updatedAt": "string"
}

2. Create Listing Entry

Create an entry for your Go Account within your enterprise listing. This enables you and others to create connections between your Go Account and theirs.

Endpoint: Create a listing entry for your enterprises Go Account

  • cURL
1
2
3
4
5
6
7
8
9
10
11
12
13
export ACCESS_TOKEN="<YOUR_ACCESS_TOKEN>"
export WALLET_ID="<YOUR_WALLET_ID>"
export DESCRIPTION="<YOUR_PUBLIC_DESCRIPTION>"

curl -X POST \
  https://app.bitgo-test.com/api/address-book/v1/listing/entry/global \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -d '{
    "walletId": "'"$WALLET_ID"'",
    "description": "'"$DESCRIPTION"'",
    "public": true
  }'

Step Result

  • JSON
1
2
3
4
5
6
7
8
9
10
11
{
  "id": "string",
  "walletId": "string",
  "coin": "string",
  "type": "GO_ACCOUNT",
  "description": "string",
  "discoverable": true,
  "featured": true,
  "createdAt": "string",
  "updatedAt": "string"
}

Next Steps

Connect Go Accounts

See Also