Accounto Public API v2 (2.0.0)

Returns a paginated list of accounts.

Example requests:

# Get first page (default 100 items)
GET /v2/{tenant_id}/accounts

# Get specific page
GET /v2/{tenant_id}/accounts?page=2

# Get specific page with custom page size
GET /v2/{tenant_id}/accounts?page=2&limit=50

Returns a list of addresses for the specified tenant.

Creates a new address for the specified tenant.

Updates an existing address for the specified tenant. Only provided fields will be updated (partial update).

Deletes an address for the specified tenant. This is a hard delete - the address is permanently removed from the database if it has no associated records.

Example request:

DELETE /v2/{tenant_id}/addresses/{address_id}

Returns a paginated list of bank transactions.

Example requests:

# Get first page (default 100 items)
GET /v2/{tenant_id}/bank_transactions

# Get specific page
GET /v2/{tenant_id}/bank_transactions?page=2

# Get specific page with custom page size
GET /v2/{tenant_id}/bank_transactions?page=2&limit=50

Creates a new bank transaction for the specified tenant.

Performs the complete booking process for a document in a single API call. This endpoint can either update an existing document or create a new one, then updates multiple related models (Document, AccountingDocument, PaymentDetails, and Bookings) in a single transaction and executes the booking process.

The operation is atomic - either all changes succeed or all changes are rolled back.

Usage:

• To book an existing document: Include the id field in the documents object
• To create and book a new document: Omit the id field and provide document creation parameters

Returns a paginated list of bookings.

Example requests:

# Get first page (default 100 items)
GET /v2/{tenant_id}/bookings

# Get specific page with date filters
GET /v2/{tenant_id}/bookings?page=2&start_date=2024-01-01&end_date=2024-12-31

# Get specific page with custom page size
GET /v2/{tenant_id}/bookings?page=2&items=50

Creates a new booking for the specified tenant.

Soft deletes a booking for the specified tenant. The booking is marked as discarded but not permanently removed from the database.

Example request:

DELETE /v2/{tenant_id}/bookings/{booking_id}

Returns a list of categories for the specified tenant.

Returns a paginated list of documents.

Example requests:

# Get first page (default 100 items)
GET /v2/{tenant_id}/documents

# Get specific page
GET /v2/{tenant_id}/documents?page=2

# Get specific page with custom page size
GET /v2/{tenant_id}/documents?page=2&limit=50

Creates a new document for the specified tenant.

Soft deletes a document for the specified tenant. The document is marked as discarded but not permanently removed from the database.

Example request:

DELETE /v2/{tenant_id}/documents/{document_id}

Returns a list of invoices for the specified tenant.

Example requests:

# Get all invoices
GET /v2/{tenant_id}/invoices

# Filter by status
GET /v2/{tenant_id}/invoices?filter[status]=draft

# Filter by invoice type
GET /v2/{tenant_id}/invoices?filter[invoice_type]=invoice

Creates a new invoice for the specified tenant.

Example request:

{
  "invoice": {
    "address_id": 100,
    "issuer_address_id": 101,
    "invoice_date": "2024-01-01",
    "due_date": "2024-01-31",
    "currency": "CHF",
    "status": "draft",
    "invoice_type": "invoice",
    "total_gross_cents": 10770,
    "total_net_cents": 10000,
    "total_tax_cents": 770,
    "vat_included": true
  }
}

Returns the OpenAPI specification for the API v2

Returns a paginated list of postings.

Example requests:

# Get first page (default 100 items)
GET /v2/{tenant_id}/postings

# Get specific page with date filters
GET /v2/{tenant_id}/postings?page=2&start_date=2024-01-01&end_date=2024-12-31

# Get specific page with custom page size
GET /v2/{tenant_id}/postings?page=2&items=50

Returns a paginated list of tags.

Example requests:

# Get first page (default 100 items)
GET /v2/{tenant_id}/tags

# Get specific page
GET /v2/{tenant_id}/tags?page=2

# Get specific page with custom page size
GET /v2/{tenant_id}/tags?page=2&limit=50

Returns a paginated list of tasks.

Example requests:

# Get first page (default 100 items)
GET /v2/{tenant_id}/tasks

# Get specific page
GET /v2/{tenant_id}/tasks?page=2

# Get specific page with custom page size
GET /v2/{tenant_id}/tasks?page=2&limit=50

Returns a paginated list of subtotals.

Example requests:

# Get first page (default 100 items)
GET /v2/{tenant_id}/subtotals

# Get specific page
GET /v2/{tenant_id}/subtotals?page=2

# Get specific page with custom page size
GET /v2/{tenant_id}/subtotals?page=2&limit=50

Uploads a file and returns a signed ID that can be used to attach the file to a document. The signed ID should be used in the source_file_signed_id parameter when creating a document.

Supported file types: PDF, JPEG, PNG, TIFF, GIF, CSV Maximum file size: 25 MB

Returns a list of VAT codes for the specified tenant.