Available

REST API + AccountsOS

Direct HTTP access to every AccountsOS tool. Bearer token authentication, JSON request and response format, and comprehensive documentation. Build custom integrations, dashboards, or agent workflows.

Get Started View API Docs

Endpoint

Scopes

JSON

Format

API request example

curl -X POST https://accounts-os.com/api/mcp \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "tool",
    "name": "get_transactions",
    "arguments": {
      "from_date": "2026-01-01",
      "to_date": "2026-01-31",
      "direction": "out",
      "limit": 50
    }
  }'

Available Tools

Tool	Description	Scope
`get_transactions`	Query income and expenses with date and direction filters	read
`get_balance`	Check current account balances across all accounts	read
`get_vat_summary`	Get VAT position for any quarter	read
`get_deadlines`	List upcoming filing deadlines	read
`create_transaction`	Record income or expense entries	write
`update_transaction`	Modify transaction details or categories	write
`categorize_transaction`	Get AI category suggestion for a transaction	write
`list_categories`	Browse HMRC-aligned expense and income categories	read
`create_deadline`	Add custom filing deadlines and reminders	write
`search_documents`	Find receipts, invoices, and contracts	read
`upload_document`	Store receipts and invoices with metadata	write
`get_dla_balance`	Check Director's Loan Account with S455 warnings	read
`get_invoices`	List and filter invoices by status	read

Features

One endpoint that runs every tool: transactions, VAT, deadlines, documents, and invoices

Bearer token authentication with scoped API keys

JSON request and response format throughout

AI-powered transaction categorisation endpoint

Writes from new keys are held for the owner to approve

120 requests a minute per key, no extra charge

How It Works

Get your API key

export ACCOUNTSOS_API_KEY="sk_live_..."

Make your first request

All requests go to /api/mcp with a JSON body specifying the tool and arguments.

curl -X POST https://accounts-os.com/api/mcp \
  -H "Authorization: Bearer $ACCOUNTSOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"tool","name":"get_balance","arguments":{}}'

Build your integration

Use any HTTP client in any language. Build dashboards, automate workflows, or power AI agents.

# Python, JavaScript, Go, Rust — any language
import requests
result = requests.post(API_URL, headers=headers, json={
  "type": "tool",
  "name": "get_transactions",
  "arguments": {"limit": 10}
}).json()

Benefits

Works with any programming language or HTTP client

Build custom dashboards, reports, and automations

Integrate accounting into existing agent workflows

Scoped API keys with read, write, and admin levels

Clear errors, rate-limit headers and a full audit log of every call

What authentication method does the API use?

Bearer token authentication. Include your API key in the Authorization header as 'Bearer sk_live_...'. API keys are scoped to read, write, or admin permissions.

What is the API request format?

All requests are POST to /api/mcp with a JSON body containing 'type' (tool or resource), 'name' (the tool name), and 'arguments' (tool-specific parameters). Responses are JSON.

Are there rate limits?

Yes. Each API key can make 120 requests a minute, at no extra charge. Successful responses carry X-RateLimit-Limit and X-RateLimit-Remaining headers, and a 429 with Retry-After means slow down. If you need more, tell us.

Can I use the API for automated workflows?

Absolutely. The API is designed for automation. Use it in cron jobs, CI/CD pipelines, serverless functions, or any scheduled workflow. Common use cases include daily expense imports, weekly finance summaries, and quarterly VAT preparation.

Related Connections

Live

Ready to connect REST API?

AI-powered accounting for your UK limited company.

Get Started Free

Free for 14 days, no credit card, cancel anytime