Altoviz Developer Hub | Blog

Changelog 2026-06-02

Tue, 02 Jun 2026 00:00:00 GMT

Tons of new APIs were added and Altoviz Developer Hub is now running on steroid.

We all need numbers, more numbers

Statistic APIs expose the numbers used in the app dashboards like :

Monthly sales and expense breakdown for a given year
Sales turnover comparison: current year, previous year, current month, previous month, and same month last year
Expense turnover comparison: current year, previous year, current month, previous month, and same month last year
Micro-business sales turnover comparison (paid invoices only): current year, previous year, current month, previous month, and same month last year
Micro-business expense turnover comparison (paid expenses only): current year, previous year, current month, previous month, and same month last year
All-time total turnover
Turnover evolution over one or more years, broken down by month
E-invoicing readiness: suppliers and customers configured, and those with issues

Data, data, data

Export APIs will allow you to export the most useful data from the app in the format you need.

Available data are :

Bank transactions
Customers
Expenses
Expenses reports
Invoices
Products
Purchases
Quotes
Receipts
Settlements
Suppliers

Formats are :

JSON
Microsoft Excel
American CSV
European CSV
TSV
Markdown

Each export was carefully built to facilitate further data analysis. They have temporal columns and relational data out-of-the-box.

Astro to the rescue

We’re now using a whole new website management tool that will ease how we publish content and how fast it is : We moved from Docusaurus to Starlight.

Starlight is made with Astro :

it has a better architecture and principles
it is easier to customize for our needs
its community is more vibrant

Changelog 2025-08-04

Mon, 04 Aug 2025 00:00:00 GMT

We introduce a whole new API reference page, easier than ever to discover and experiment the Altoviz API.

New API reference page

The new API reference page brings some important new features :

an easier way discovery all the possibilities offered by the API, thanks to a whole new layout
support for light and dark theme
a dedicated search engine
more supported languages for the examples
a ability the live test the API from your browser

Changelog 2025-01-22

Wed, 22 Jan 2025 00:00:00 GMT

Some great new possibilities for API amateurs : Suppliers, receipts and metadata.

New receipts API

You can list, add, edit and delete receipts /v1/Receipts

New suppliers API

You can list, add, edit and delete suppliers /v1/Suppliers

Metadata on Mark as paid

Metadata allow you to store important informations for your app on Altoviz entities. We added the possibility to pass metadata to the mark-as-paid API. Those metadata will be stored on the payment.

Changelog 2024-08-28

Wed, 28 Aug 2024 00:00:00 GMT

Following your feedback, we added a lot of new APIs and extended existing APIs. This post will make a little recap of the new stuff added in the last months.

Introducing “internal id”

You might need to create an integration of the Altoviz services with your product and in case you have common entities, you will have to keep the data in sync. That’s why we added an “internal id” on entites such as contacts, customers, products, quotes and invoices.

As an example, if you have contacts within your app and those contacts have their own unique id, you can set this unique id to the internal id of the Altoviz customer. You wil then be able to get this customer back using your unique id and not the Altoviz one. You no longer have to save Altoviz ids.

Purchase invoices

You can create purchase invoices just by sending a PDF file to the app through the /v1/purchaseinvoices/file API.

Purchase invoices can be downloaded too using the /v1/PurchaseInvoices/Download API.

Sales invoices

Invoices can be updated and deleted as long as they are still in draft mode.

Invoices can be marked as paid. Set the date and payment method method and you’re done. Just one call to this API to finalize and pay an invoice ! /v1/SaleInvoices/Finalize

You can find invoices using your own id (internal Id).

Notes becomes Footer notes and Header notes was added.

You can sort the result, filter by dates, customer or status and even include canceled invoices. v1/SaleInvoices

Sales quotes

Delete a quote

Find quote by internal Id

Sales credits

Just like sales invoices, you can list, add, edit and remove sales credits.

Units

List all available units. If you need to add, edit or remove units, dot it in the app.

Get a customer using an internal Id

You can get a customer by its internal id (the id coming from your app) using the v1/Customers/GetByInternalId API

Get product famillies

You can get a customer family by its internal id (the id coming from your app) using the /v1/CustomerFamilies API

Add and update product images

You can add, update and get product images using the Product images APIs API

Check your key

We added a very simple API to quickly check your API key. Just call /hello with your API key.

API reference documentation lists fields ordered

To make the reference documentation even easier to read, fields are now sorted alphabeticaly.

Changelog 2023-10-19

Thu, 19 Oct 2023 00:00:00 GMT

Support for basic authentication

An additional authentication method is introduced using HTTP basic authenticationa. Read more

New API for units

You can get the units list using the Units API

Classification filter by type

A new type parameter allow to filter the returned classifications.

Changelog 2023-10-05

Thu, 05 Oct 2023 00:00:00 GMT

API key by parameter

An additional authentication method is introduced using a URL parameter. Read more

POST content no longer needs Id

Some API like contact creation or customer update had a useless Id member.

New webhooks

We added more webhooks to give you more control over what happens in the app. Read more

Settings API

A new settings API allows you to get all settings including timezone, logo, vat number, var mode and more.

curl -iH "x-api-key:5b26c099-5d5e-4087-90a0-722f9d5b92ee" https://api.altoviz.com/v1/settings

Changelog 2023-09-21

Thu, 21 Sep 2023 00:00:00 GMT

new API to get VATs

You might need to create an invoice from scratch, without using any existing product, so you will have to spefify the appropriate VAT for each line. Those things are not frequently changing but a better approach than hard coding is to list the VATs.

curl -iH "x-api-key:5b26c099-5d5e-4087-90a0-722f9d5b92ee" https://api.altoviz.com/v1/vats

The result is a list of all existing VAT

[
  { "id": 22, "rate": 0.0, "region": "FR", "label": "0.0% - FR" },
  { "id": 23, "rate": 0.0, "region": "EU", "label": "0.0% - EU" },
  { "id": 24, "rate": 0.0, "region": "IE", "label": "0.0% - IE" },
  { "id": 25, "rate": 20.0, "region": "FR", "label": "20.0% - FR" },
  { "id": 26, "rate": 10.0, "region": "FR", "label": "10.0% - FR" },
  { "id": 27, "rate": 5.5, "region": "FR", "label": "5.500% - FR" },
  { "id": 28, "rate": 2.1, "region": "FR", "label": "2.100% - FR" }
]

REST API reference

new API to get classifications

Classifications are our way to produce accounting registers from user created invoices. You can now get a complete list of existing classifications.

curl -iH "x-api-key:5b26c099-5d5e-4087-90a0-722f9d5b92ee" https://api.altoviz.com/v1/classifications

The result is a list of classification with all the detail. Did you notice the associated VAT ?

[
  {
    "id": 162,
    "label": "Abonnements/Locations",
    "description": "Abonnement ou location de matériel (hors locations mobilières/immobilières), hébergement de site internet...",
    "accountNumber": "6131",
    "defaultVat": {
      "id": 25,
      "rate": 20.0,
      "region": "FR",
      "label": "20.0% - FR"
    },
    "isProduct": false,
    "isService": false,
    "type": "Expense",
    "microBusinessDeclarationType": null
  },
  {
    "id": 154,
    "label": "Accessoires et petits matériels",
    "description": "Biens et équipements dont la valeur est inférieure à 500€ HT : bureau, tablette, téléphone, etc.",
    "accountNumber": "6051",
    "defaultVat": null,
    "isProduct": false,
    "isService": false,
    "type": "Expense",
    "microBusinessDeclarationType": null
  }
]

REST API reference

Hello World !

Tue, 19 Sep 2023 00:00:00 GMT

This is a very special day today for the Altoviz team. We are launching our initiative for developers including :

a website dedicated to developers developer.altoviz.com
the public RESTful APIs of the Altoviz platform
the Altoviz GitHub page

Altoviz public APIs

The Altoviz platform provides free RESTful APIs to deal with quotes, invoices, contacts, customers and products.
This is a great opportunity for every developers creating apps and solutions that at some point could generate invoices or sync contacts.

Altoviz Developer Hub

We created the Altoviz Developer Hub website to publish developer oriented content only. App users and customers will still use the mainstream blog on altoviz.com.
Everything useful we provide for developer will be there : A complete and up to date documentation for the APIs, tutorials and a blog. For samples and code, check out our GitHub page.
We’ll use the blog for every announcements. To ensure that you’ll not miss a thing, use the RSS feed or subscribe to the developer e-mail list in your account.

Altoviz GitHub page

We share our code samples on GitHub 🐙 so every developers can explore, resuse and enhance them.
If you create a project on GitHub related to Altoviz, feel free to ping us. We will be more than happy to promote it.

The possibilities are endless, so are the opportunities. We can’t wait to see what awesome things developers will do with the Altoviz APIs.