openapi: 3.0.3
info:
title: bexio Accounting API
description: REST API for bexio, the Swiss cloud business-management platform (accounting, invoicing, contacts, projects, payroll). All endpoints are served over HTTPS under https://api.bexio.com/2.0. JSON is the data-interchange format. Authentication is OAuth 2.0 Authorization Code (OpenID Connect) or a Personal Access Token (PAT); both are presented as a Bearer token. This document is modeled from the public documentation, not a first-party spec.
termsOfService: https://www.bexio.com/en-CH/gtc
contact:
name: bexio Developer Support
url: https://developer.bexio.com/
version: '2.0'
servers:
- url: https://api.bexio.com/2.0
description: bexio API v2.0 (Switzerland)
security:
- bearerAuth: []
tags:
- name: Accounting
paths:
/accounts:
get:
operationId: listAccounts
tags:
- Accounting
summary: List chart-of-accounts entries (Konten)
responses:
'200':
description: A list of accounts.
/currencies:
get:
operationId: listCurrencies
tags:
- Accounting
summary: List currencies
responses:
'200':
description: A list of currencies (CHF and others).
/taxes:
get:
operationId: listTaxes
tags:
- Accounting
summary: List VAT (MWST) tax rates
responses:
'200':
description: A list of Swiss VAT tax definitions.
/accounting/manual_entries:
get:
operationId: listManualEntries
tags:
- Accounting
summary: List manual journal entries (Buchungen)
responses:
'200':
description: A list of manual entries.
post:
operationId: createManualEntry
tags:
- Accounting
summary: Create a manual journal entry
requestBody:
required: true
content:
application/json:
schema:
type: object
responses:
'201':
description: The created manual entry.
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: 'OAuth 2.0 Authorization Code (OpenID Connect, issuer https://auth.bexio.com/realms/bexio) access token, or a Personal Access Token (PAT), presented as an Authorization: Bearer header.'