GET

Get user categories with subscription status

Retrieves all available notification categories with their current subscription status for the authenticated user and specified channel. A category is considered 'subscribed' if all non-mandatory notifications within that category are subscribed for the specified channel.

Query Params

channel string required

Header Params

request-id string

Responses

200

List of categories with subscription status

Response Body

object

categories array of objects required
categories object
- categoryName string enum required
  
  accessaccess_tokensapproval_completedapproval_requiredbank_accounts_and_fiat_operationsbank_and_trustfinancinggo_networkidentityoesreportstradeumswallet_notificationstransaction_monitoringstaking_rewardstreasury_managementstuck_transaction_notification
- isSubscribed boolean required
- isMandatory boolean required

400

Invalid channel query parameter

Response Body

object

Bad request error response

name string enum required

Error code

ValidationFailedIllegalArgumentBadRequestDataIntegrityErrorNotImplementedErrorRETRIGGER_RATE_LIMITEDUSER_CREATION_FAILEDUSER_FALLBACK_FAILED
error string required

Human-readable error message
status integer enum int32 required

HTTP status code

400

500

Unexpected error

Response Body

object

Internal server error response

name string enum required

Error code

UnexpectedErrorThirdPartyErrorDatabaseErrorUSER_FALLBACK_TIMEOUT
error string required

Human-readable error message
status integer enum int32 required

HTTP status code

500

curl --request GET \ --url 'https://app.bitgo-test.com/api/notifications/v1/user/categories?channel=string' \ --header 'accept: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --header 'request-id: string'

const url = 'https://app.bitgo-test.com/api/notifications/v1/user/categories?channel=string'; const options = {method: 'GET', headers: {accept: 'application/json', 'Authorization': 'Bearer YOUR_ACCESS_TOKEN', 'request-id': 'string'}}; 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/notifications/v1/user/categories?channel=string") 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' request["request-id"] = 'string' 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/notifications/v1/user/categories?channel=string', [ 'headers' => [ 'accept' => 'application/json', 'Authorization' => 'Bearer YOUR_ACCESS_TOKEN', 'request-id' => 'string', ], ]); echo $response->getBody();

import requests url = "https://app.bitgo-test.com/api/notifications/v1/user/categories?channel=string" headers = { "accept": "application/json", "Authorization": "Bearer YOUR_ACCESS_TOKEN", "request-id": "string" } response = requests.get(url, headers=headers) print(response.text)