Call credits.balance

curl --request POST \
  --url https://app.goosybear.ai/api/v1/tools/credits.balance \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

import requests

url = "https://app.goosybear.ai/api/v1/tools/credits.balance"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://app.goosybear.ai/api/v1/tools/credits.balance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.goosybear.ai/api/v1/tools/credits.balance",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.goosybear.ai/api/v1/tools/credits.balance"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.goosybear.ai/api/v1/tools/credits.balance")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.goosybear.ai/api/v1/tools/credits.balance")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"

response = http.request(request)
puts response.read_body

{
  "ok": true,
  "balance": 123
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retry_after_seconds": 123
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retry_after_seconds": 123
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retry_after_seconds": 123
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retry_after_seconds": 123
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retry_after_seconds": 123
  }
}

POST

api

tools

credits.balance

Call credits.balance

curl --request POST \
  --url https://app.goosybear.ai/api/v1/tools/credits.balance \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

import requests

url = "https://app.goosybear.ai/api/v1/tools/credits.balance"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://app.goosybear.ai/api/v1/tools/credits.balance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.goosybear.ai/api/v1/tools/credits.balance",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.goosybear.ai/api/v1/tools/credits.balance"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.goosybear.ai/api/v1/tools/credits.balance")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.goosybear.ai/api/v1/tools/credits.balance")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"

response = http.request(request)
puts response.read_body

{
  "ok": true,
  "balance": 123
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retry_after_seconds": 123
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retry_after_seconds": 123
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retry_after_seconds": 123
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retry_after_seconds": 123
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retry_after_seconds": 123
  }
}

Authorizations

Authorization

string

header

required

An API key minted at Settings › API & MCP. Send it as Authorization: Bearer <key>. A key carries its holder's own permissions, resolved on every call — revoking a membership closes the key's reach immediately. Keep it in an environment variable (GOOSY_API_KEY), never in a committed file.

Body

application/json

The body is of type object.

Response

The call was admitted and dispatched. ok says whether the tool succeeded — a refusal the tool itself produced is still a 200, exactly as it is a successful JSON-RPC result over MCP.

Option 1
Option 2

The tool ran and answered.

boolean

required

balance

number

required

How many credits are left on the account that pays for this workspace.

Get started

API guides

Connect an assistant

API reference

Call credits.balance

Authorizations

Body

Response