Using the AccBooks API

Overview

The AccBooks REST API lets you read and write data programmatically — pull financial reports into your own dashboards, push transactions from your sales systems, or build custom integrations not available out of the box.

The API is available on all AccBooks plans. Rate limits vary by plan.

Base URL

https://api.accbooks.co.uk/v1/

All requests must be made over HTTPS. HTTP requests are rejected.

Authentication

AccBooks uses API keys for authentication. Each API key is scoped to a specific company and a set of permissions.

Generating an API key:

1. Go to Settings → Integrations → API → Keys → Create key.
2. Give the key a name (e.g., “Dashboard integration”).
3. Select the permissions (read-only, read-write, or custom).
4. Click Create. The key is shown once — copy and store it securely.

Using the API key: Include the key as a Bearer token in every request:

GET /v1/transactions HTTP/1.1
Authorization: Bearer your_api_key_here
Content-Type: application/json

Key permissions

Permission	Read	Write
transactions	List, get	Create, update
invoices	List, get	Create, update, delete
contacts	List, get	Create, update
reports	P&L, balance sheet, trial balance	—
journals	List, get	Create
bank_accounts	List, get	—
company	Get	—

Common endpoints

List transactions

GET /v1/transactions?from=2026-01-01&to=2026-03-31&account_id=1001

Create an invoice

POST /v1/invoices
{
  "customer_id": "cust_123",
  "date": "2026-04-15",
  "due_date": "2026-05-15",
  "line_items": [
    {
      "description": "Consulting services — April",
      "quantity": 1,
      "unit_price": 2500.00,
      "vat_rate": "20",
      "nominal_code": "4000"
    }
  ]
}

Get P&L report

GET /v1/reports/profit-loss?from=2026-04-01&to=2027-03-31&format=json

Rate limits

Plan	Requests per minute	Requests per day
Starter	60	10,000
Pro	300	100,000
Enterprise	Custom	Custom

Rate limit headers are returned on every response:

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 299
X-RateLimit-Reset: 1714000000

Pagination

All list endpoints return paginated results:

GET /v1/transactions?page=2&per_page=100

Response includes:

{
  "data": [...],
  "meta": {
    "current_page": 2,
    "total_pages": 5,
    "total_records": 487
  }
}

Webhooks

Instead of polling the API, use webhooks to receive real-time notifications when events occur. See Webhooks for details.

API reference

Full API documentation with endpoint definitions, request/response schemas and code examples in Python, JavaScript and PHP is available at:

developer.accbooks.co.uk

Support

For API integration questions, join the AccBooks developer community at community.accbooks.co.uk or contact developer support at [email protected].