API Overview

The Invoica API is a RESTful JSON API for managing invoices, settlements, tax calculations, and budgets.

Base URL

https://api.invoica.ai

All API endpoints are relative to this base URL.

Include your API key in every request:

curl -H "Authorization: Bearer inv_your_key_here" \
  https://api.invoica.ai/api/invoices

See the Authentication guide for details.

All responses follow a consistent structure:

{
  "id": "inv_8a7b6c5d4e3f2a1b",
  "invoiceNumber": "INV-2026-0001",
  "status": "draft",
  "amount": 5000,
  "createdAt": "2026-02-18T10:30:00Z"
}

{
  "data": [...],
  "total": 142,
  "page": 1,
  "limit": 10,
  "hasMore": true
}

{
  "error": {
    "code": "INVALID_AMOUNT",
    "message": "Amount must be a positive integer",
    "status": 400
  }
}

Status	Code	Description
400	`INVALID_REQUEST`	Malformed request body or missing required fields
401	`UNAUTHORIZED`	Invalid or missing API key
403	`FORBIDDEN`	Key lacks required permissions
404	`NOT_FOUND`	Resource does not exist
402	`BUDGET_EXCEEDED`	Agent budget limit reached
429	`RATE_LIMITED`	Too many requests
500	`INTERNAL_ERROR`	Server error — contact support

API requests are rate limited per API key:

Rate limit headers are included in every response:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1708254600

List endpoints support cursor-based pagination:

GET /api/invoices?limit=10&page=2

Parameter	Type	Description
`limit`	integer	Items per page (default: 10, max: 100)
`page`	integer	Page number (default: 1)