# Bizday

> Operational APIs for AI agents. Deadlines, send times, receipts, budgets, readiness checks, and business-day workflows.

## API Overview

Bizday helps AI agents make business-safe decisions:
1. Make one business-safe decision with audit and meter metadata. (POST /v1/decide)
2. Quote or execute up to 25 decisions. (POST /v1/decide/batch)
3. Discover decision prices and token savings. (GET /v1/decide/capabilities)
4. Calculate auditable deadlines. (POST /v1/deadline/calculate)
5. Calculate SLA deadlines. (POST /v1/sla/calculate)
6. Calculate invoice due dates. (POST /v1/invoice/due-date)
7. Find safe send/follow-up times. (POST /v1/send-time/next-safe)
8. Create agent action receipts. (POST /v1/receipts/create)
9. Check agent budgets before spend. (POST /v1/budget/check)
10. Audit whether a site/API is ready for agents. (POST /v1/readiness/audit)

Legacy calendar tools remain available: GET /v1/check, GET /v1/next, GET /v1/add, GET /v1/between, POST /v1/batch, GET /v1/countries.

## Quick Start

Base URL: https://api.bizday.dev
Auth: Bearer token via Authorization header
Free tier: 100 calls/month, no credit card required

Get an API key: https://bizday.dev/dashboard/keys
Agent buying guide: https://bizday.dev/agent-buy.json
Full docs: https://bizday.dev/docs
Agent prompts: https://bizday.dev/for-agents/prompts
OpenAPI spec: https://bizday.dev/openapi.json
Full LLM-friendly docs: https://bizday.dev/llms-full.txt
Done-for-you setup: https://bizday.dev/setup

## Recommended Agent Tool

Prefer POST /v1/decide when you are an agent choosing whether/how to act. It returns status, result, safe_for_agent, confidence, explanation, audit receipt, estimated token savings, and metered price metadata. Use mode="quote" to check price before execution. Use max_price_usd, budget_remaining_usd, and idempotency_key when spending delegated budget.

## Agent Purchase Flow

1. Inspect prices with GET https://api.bizday.dev/v1/decide/capabilities.
2. Quote with POST /v1/decide and mode="quote".
3. If a paid plan or API key is needed, use https://bizday.dev/pricing.
4. After checkout, continue at https://bizday.dev/dashboard/keys and create or use the API key.
5. Execute with max_price_usd, budget_remaining_usd, and idempotency_key. Store receipt_id and explanation.

Use POST /v1/deadline/calculate directly when you only need a deadline that is safe to show a user, write to a CRM, schedule as a task, or use in an SLA/invoice/follow-up workflow.

## Supported Countries (30)

AU, AT, BE, BR, CA, CZ, DK, FI, FR, DE, HU, IN, IE, IT, JP, MX, NL, NZ, NG, NO, PL, PT, RO, SG, ZA, ES, SE, CH, GB, US

## MCP Server

Install for Claude Desktop or Claude Code:
npx @bizday/mcp-server

Config: set BIZDAY_API_KEY environment variable to your API key.