TipCalculate API

curl https://tipcalculateapp.com/api/tips \
  -H "Authorization: Bearer $TIPCALCULATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "billAmount": 64.20,
    "tipPercentage": 20,
    "tipAmount": 12.84,
    "totalAmount": 77.04,
    "peopleCount": 2,
    "businessName": "Harbor Lane Cafe",
    "categoryId": "cafe",
    "notes": "Table 12"
  }'

const bill = 64.2;
const percent = 20;
const tip = Math.round(bill * percent) / 100;

const res = await fetch('https://tipcalculateapp.com/api/tips', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.TIPCALCULATE_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    billAmount: bill,
    tipPercentage: percent,
    tipAmount: tip,
    totalAmount: Math.round((bill + tip) * 100) / 100,
    peopleCount: 2,
    businessName: 'Harbor Lane Cafe',
    categoryId: 'cafe',
    notes: 'Table 12',
  }),
});
if (!res.ok) throw new Error((await res.json()).error);

const { id, tip: saved } = await res.json();
console.log(`Saved ${id}: $${saved.tipAmount} tip, $${saved.totalAmount} total`);

import os
import requests

bill, percent = 64.20, 20
tip = round(bill * percent / 100, 2)

res = requests.post(
    "https://tipcalculateapp.com/api/tips",
    headers={"Authorization": f"Bearer {os.environ['TIPCALCULATE_API_KEY']}"},
    json={
        "billAmount": bill,
        "tipPercentage": percent,
        "tipAmount": tip,
        "totalAmount": round(bill + tip, 2),
        "peopleCount": 2,
        "businessName": "Harbor Lane Cafe",
        "categoryId": "cafe",
        "notes": "Table 12",
    },
    timeout=10,
)
res.raise_for_status()
saved = res.json()["tip"]
print(f"Saved {saved['id']}: ${saved['tipAmount']} tip, ${saved['totalAmount']} total")

struct NewTip: Encodable {
    let billAmount: Double
    let tipPercentage: Int
    let tipAmount: Double
    let totalAmount: Double
    let peopleCount: Int
    let businessName: String
    let categoryId: String
}

var request = URLRequest(url: URL(string: "https://tipcalculateapp.com/api/tips")!)
request.httpMethod = "POST"
request.setValue("Bearer \(apiKey)", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try JSONEncoder().encode(NewTip(
    billAmount: 64.20, tipPercentage: 20, tipAmount: 12.84, totalAmount: 77.04,
    peopleCount: 2, businessName: "Harbor Lane Cafe", categoryId: "cafe"))

let (data, response) = try await URLSession.shared.data(for: request)
guard (response as? HTTPURLResponse)?.statusCode == 201 else {
    throw URLError(.badServerResponse)
}
print(String(decoding: data, as: UTF8.self))

curl "https://tipcalculateapp.com/api/tips?limit=5" \
  -H "Authorization: Bearer $TIPCALCULATE_API_KEY"

const res = await fetch('https://tipcalculateapp.com/api/tips?limit=5', {
  headers: { Authorization: `Bearer ${process.env.TIPCALCULATE_API_KEY}` },
});
const { tips } = await res.json();

for (const t of tips) {
  const date = new Date(t.timestamp).toLocaleDateString('en-US');
  const place = (t.businessName || 'Tip').padEnd(20);
  console.log(`${date.padEnd(10)} ${place} ${t.tipAmount.toFixed(2).padStart(7)}  (${t.tipPercentage}%)`);
}

import os
from datetime import datetime
import requests

res = requests.get(
    "https://tipcalculateapp.com/api/tips",
    params={"limit": 5},
    headers={"Authorization": f"Bearer {os.environ['TIPCALCULATE_API_KEY']}"},
    timeout=10,
)
res.raise_for_status()

for t in res.json()["tips"]:
    date = datetime.fromtimestamp(t["timestamp"] / 1000)
    place = t.get("businessName") or "Tip"
    print(f"{date:%m/%d/%Y}  {place:<20} {t['tipAmount']:7.2f}  ({t['tipPercentage']}%)")

struct TipList: Decodable { let tips: [Tip] }
struct Tip: Decodable {
    let id: String
    let businessName: String?
    let tipAmount: Double
    let tipPercentage: Int
    let totalAmount: Double
    let timestamp: Double
}

var request = URLRequest(url: URL(string: "https://tipcalculateapp.com/api/tips?limit=5")!)
request.setValue("Bearer \(apiKey)", forHTTPHeaderField: "Authorization")

let (data, _) = try await URLSession.shared.data(for: request)
for tip in try JSONDecoder().decode(TipList.self, from: data).tips {
    let date = Date(timeIntervalSince1970: tip.timestamp / 1000)
    print(date.formatted(date: .numeric, time: .omitted), tip.businessName ?? "Tip",
          tip.tipAmount.formatted(.currency(code: "USD")))
}

const res = await fetch('https://tipcalculateapp.com/api/tips?limit=100', {
  headers: { Authorization: `Bearer ${process.env.TIPCALCULATE_API_KEY}` },
});
const { tips } = await res.json();

const months = {};
for (const t of tips) {
  const month = new Date(t.timestamp).toISOString().slice(0, 7); // "2026-10"
  months[month] ??= { count: 0, tipped: 0, billed: 0 };
  months[month].count += 1;
  months[month].tipped += t.tipAmount;
  months[month].billed += t.billAmount;
}

for (const [month, m] of Object.entries(months).sort()) {
  const average = (m.tipped / m.billed) * 100;
  console.log(`${month}  ${m.count} tips  $${m.tipped.toFixed(2).padStart(6)} tipped  avg ${average.toFixed(1)}%`);
}

import os
from collections import defaultdict
from datetime import datetime, timezone
import requests

res = requests.get(
    "https://tipcalculateapp.com/api/tips",
    params={"limit": 100},
    headers={"Authorization": f"Bearer {os.environ['TIPCALCULATE_API_KEY']}"},
    timeout=10,
)
res.raise_for_status()

months = defaultdict(lambda: {"count": 0, "tipped": 0.0, "billed": 0.0})
for t in res.json()["tips"]:
    month = datetime.fromtimestamp(t["timestamp"] / 1000, timezone.utc).strftime("%Y-%m")
    months[month]["count"] += 1
    months[month]["tipped"] += t["tipAmount"]
    months[month]["billed"] += t["billAmount"]

for month, m in sorted(months.items()):
    average = m["tipped"] / m["billed"] * 100
    print(f"{month}  {m['count']} tips  ${m['tipped']:6.2f} tipped  avg {average:.1f}%")

import os
from collections import Counter
import requests

res = requests.get(
    "https://tipcalculateapp.com/api/tips",
    params={"limit": 100},
    headers={"Authorization": f"Bearer {os.environ['TIPCALCULATE_API_KEY']}"},
    timeout=10,
)
res.raise_for_status()
tips = res.json()["tips"]

by_category = Counter()
for t in tips:
    by_category[t.get("categoryId", "other")] += t["tipAmount"]

total = sum(by_category.values())
for category, amount in by_category.most_common():
    bar = "█" * round(amount / total * 25)
    print(f"{category:<11} ${amount:7.2f}  {bar}")

const res = await fetch('https://tipcalculateapp.com/api/tips?limit=100', {
  headers: { Authorization: `Bearer ${process.env.TIPCALCULATE_API_KEY}` },
});
const { tips } = await res.json();

const byCategory = {};
for (const t of tips) {
  const id = t.categoryId ?? 'other';
  byCategory[id] = (byCategory[id] ?? 0) + t.tipAmount;
}

const total = Object.values(byCategory).reduce((a, b) => a + b, 0);
for (const [id, amount] of Object.entries(byCategory).sort((a, b) => b[1] - a[1])) {
  const bar = '█'.repeat(Math.round((amount / total) * 25));
  console.log(`${id.padEnd(11)} $${amount.toFixed(2).padStart(7)}  ${bar}`);
}

// In your sheet: Extensions → Apps Script. Save your key under
// Project Settings → Script properties as TIPCALCULATE_API_KEY.
// Add a time-driven trigger to run importTips every morning.
function importTips() {
  const key = PropertiesService.getScriptProperties().getProperty('TIPCALCULATE_API_KEY');
  const res = UrlFetchApp.fetch('https://tipcalculateapp.com/api/tips?limit=100', {
    headers: { Authorization: 'Bearer ' + key },
  });
  const { tips } = JSON.parse(res.getContentText());

  const rows = tips.map((t) => [
    new Date(t.timestamp),
    t.businessName || '',
    t.categoryId,
    t.billAmount,
    t.tipPercentage / 100,
    t.tipAmount,
  ]);

  const sheet = SpreadsheetApp.getActiveSheet();
  sheet.clearContents();
  sheet.appendRow(['Date', 'Place', 'Category', 'Bill', 'Tip %', 'Tip']);
  if (rows.length) sheet.getRange(2, 1, rows.length, 6).setValues(rows);
  sheet.getRange('E2:E').setNumberFormat('0%');
}