API reference

# pip install requests
import requests

API_KEY = "your_2ba_api_key"  # from your 2BA dashboard

d = requests.post("https://api.2ba.ai/v1/choices",
    headers={"Authorization": "Bearer " + API_KEY},
    json={
        "state": "Customer was charged twice for the same invoice.",
        "question": "Which queue should handle this request?",
        "options": [
            {"id": "billing", "description": "Invoices, payments, refunds"},
            {"id": "technical", "description": "Bugs, outages, system errors"},
            {"id": "sales", "description": "Pricing and account questions"}],
    }).json()

print(d["choice"], d["vote_split"], d["abstained"])

// Standard library only.
package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"strings"
)

func main() {
	body := `{"state": "Customer was charged twice for the same invoice.",
		"question": "Which queue should handle this request?",
		"options": [
			{"id": "billing", "description": "Invoices, payments, refunds"},
			{"id": "technical", "description": "Bugs, outages, system errors"},
			{"id": "sales", "description": "Pricing and account questions"}]}`
	req, err := http.NewRequest("POST", "https://api.2ba.ai/v1/choices", strings.NewReader(body))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer your_2ba_api_key")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	var d struct {
		Choice    string         `json:"choice"`
		VoteSplit map[string]int `json:"vote_split"`
		Abstained bool           `json:"abstained"`
	}
	if err := json.NewDecoder(res.Body).Decode(&d); err != nil {
		panic(err)
	}
	fmt.Println(d.Choice, d.VoteSplit, d.Abstained)
}

// Node 18+, Deno and Bun: fetch is built in.
const res = await fetch("https://api.2ba.ai/v1/choices", {
  method: "POST",
  headers: {
    Authorization: "Bearer your_2ba_api_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    state: "Customer was charged twice for the same invoice.",
    question: "Which queue should handle this request?",
    options: [
      { id: "billing", description: "Invoices, payments, refunds" },
      { id: "technical", description: "Bugs, outages, system errors" },
      { id: "sales", description: "Pricing and account questions" },
    ],
  }),
});

const decision = await res.json();
console.log(decision.choice, decision.vote_split, decision.abstained);