Altoviz

Altoviz Exports API

Export API — download workbook data as Excel, CSV, TSV or JSON. All endpoints accept the common filter params documented below. Additional upstream filter params (status, colleagueId, types[], …) can be appended to the query string and are forwarded transparently.

Documentation GitHub OpenAPI

Operations 13

GET /v1/exports/salesinvoices Export sales invoices (and optionally credits) #

GET /v1/exports/salesquotes Export sales quotes #

GET /v1/exports/salescredits Export sales credit notes #

GET /v1/exports/products Export the product catalogue #

GET /v1/exports/customers Export customers #

GET /v1/exports/suppliers Export suppliers #

GET /v1/exports/expensesbook Export the expenses accounting register #

GET /v1/exports/receiptsbook Export the receipts accounting register #

GET /v1/exports/banktransactions/{id} Export bank transactions for a specific account #

GET /v1/exports/expensecharges Export purchase invoices (expense charges) #

GET /v1/exports/expensereports Export expense reports #

GET /v1/exports/settlements Export settlements (customer receipts, supplier payments, colleague repayments). #

GET /v1/exports/commitments Export commitments / due dates (customer, supplier, colleague). #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/altoviz-com/openapi/altoviz-com-exports-api-openapi.yml

Schemas & Data

📊

JSONSchema

https://artifacts.apis.io/altoviz-com/json-schema/altoviz-com-invoice-schema.json

📊

JSONSchema

https://artifacts.apis.io/altoviz-com/json-schema/altoviz-com-credit-schema.json

📊

JSONSchema

https://artifacts.apis.io/altoviz-com/json-schema/altoviz-com-quote-schema.json

📊

JSONSchema

https://artifacts.apis.io/altoviz-com/json-schema/altoviz-com-product-schema.json

📊

JSONSchema

https://artifacts.apis.io/altoviz-com/json-schema/altoviz-com-bank-account-schema.json

📊

JSONSchema

https://artifacts.apis.io/altoviz-com/json-schema/altoviz-com-bank-transaction-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/altoviz-com:altoviz-com-exports-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Altoviz Exports API
  description: 'RESTful APIs for the Altoviz services


    ## Deprecations


    ### Product prices


    A product now stores its sale price both excluding and including tax, so both are

    returned, along with the margin figures derived from them: `taxExcludedPrice`,

    `taxIncludedPrice`, `margin`, `markupRate` (margin over cost, FR « taux de marge ») and

    `marginRate` (margin over sale price, FR « taux de marque »).


    Two fields are deprecated as a result:


    | Deprecated | Use instead |

    | --- | --- |

    | `unitPrice` | `taxExcludedPrice` |

    | `isUnitPriceTaxIncluded` | `taxIncludedPrice`, to send a tax-included price |


    **`unitPrice` is now always the tax-excluded price.** It previously held whichever half

    the product was priced in, which `isUnitPriceTaxIncluded` told you. For a product priced

    tax-included, `unitPrice` therefore returns a different number than it used to, and

    `isUnitPriceTaxIncluded` is now always `false`. If you read the flag before using the

    price, your result is unchanged. If you assumed the price was tax-included, read

    `taxIncludedPrice`.


    Writing is unaffected. Both fields are still accepted and behave exactly as before:

    `unitPrice` alone is read as tax-excluded, and setting `isUnitPriceTaxIncluded` to `true`

    still means the price you are sending includes tax. `margin`, `markupRate` and

    `marginRate` are derived by the server and ignored if sent.'
  contact:
    name: Altoviz
    email: contact@altoviz.com
  license:
    name: Altoviz license
    url: https://altoviz.com/license
  version: v1
  x-logo:
    url: https://altoviz.com/altoviz-logo-ext-violet-262x72.png
    altText: Altoviz logo
servers:
- url: https://api.altoviz.com
  description: Altoviz
security:
- {}
tags:
- name: Exports
  description: 'Export API — download workbook data as Excel, CSV, TSV or JSON.

    All endpoints accept the common filter params documented below.

    Additional upstream filter params (status, colleagueId, types[], …)

    can be appended to the query string and are forwarded transparently.'
paths:
  /v1/exports/salesinvoices:
    get:
      tags:
      - Exports
      summary: Export sales invoices (and optionally credits)
      operationId: GET_Exports_SalesInvoices
      parameters:
      - name: from
        in: query
        description: Start date (inclusive).
        schema:
          type: string
          format: date
      - name: to
        in: query
        description: End date (inclusive).
        schema:
          type: string
          format: date
      - name: customerId
        in: query
        description: Filter by customer ID.
        schema:
          type: integer
          format: int32
      - name: searchTerm
        in: query
        description: Full-text search.
        schema:
          type: string
      - name: sheets
        in: query
        description: Which sheets to include.
        schema:
          $ref: '#/components/schemas/ExportSheets'
      - name: format
        in: query
        description: Output format.
        schema:
          $ref: '#/components/schemas/ExportFileFormat'
      responses:
        '200':
          description: OK
  /v1/exports/salesquotes:
    get:
      tags:
      - Exports
      summary: Export sales quotes
      operationId: GET_Exports_SalesQuotes
      parameters:
      - name: from
        in: query
        description: Start date (inclusive).
        schema:
          type: string
          format: date
      - name: to
        in: query
        description: End date (inclusive).
        schema:
          type: string
          format: date
      - name: customerId
        in: query
        description: Filter by customer ID.
        schema:
          type: integer
          format: int32
      - name: searchTerm
        in: query
        description: Full-text search.
        schema:
          type: string
      - name: sheets
        in: query
        description: Which sheets to include.
        schema:
          $ref: '#/components/schemas/ExportSheets'
      - name: format
        in: query
        description: Output format.
        schema:
          $ref: '#/components/schemas/ExportFileFormat'
      responses:
        '200':
          description: OK
  /v1/exports/salescredits:
    get:
      tags:
      - Exports
      summary: Export sales credit notes
      operationId: GET_Exports_SalesCredits
      parameters:
      - name: from
        in: query
        description: Start date (inclusive).
        schema:
          type: string
          format: date
      - name: to
        in: query
        description: End date (inclusive).
        schema:
          type: string
          format: date
      - name: customerId
        in: query
        description: Filter by customer ID.
        schema:
          type: integer
          format: int32
      - name: searchTerm
        in: query
        description: Full-text search.
        schema:
          type: string
      - name: sheets
        in: query
        description: Which sheets to include.
        schema:
          $ref: '#/components/schemas/ExportSheets'
      - name: format
        in: query
        description: Output format.
        schema:
          $ref: '#/components/schemas/ExportFileFormat'
      responses:
        '200':
          description: OK
  /v1/exports/products:
    get:
      tags:
      - Exports
      summary: Export the product catalogue
      operationId: GET_Exports_Products
      parameters:
      - name: searchTerm
        in: query
        description: Full-text search.
        schema:
          type: string
      - name: sheets
        in: query
        description: Which sheets to include.
        schema:
          $ref: '#/components/schemas/ExportSheets'
      - name: format
        in: query
        description: Output format.
        schema:
          $ref: '#/components/schemas/ExportFileFormat'
      responses:
        '200':
          description: OK
  /v1/exports/customers:
    get:
      tags:
      - Exports
      summary: Export customers
      operationId: GET_Exports_Customers
      parameters:
      - name: searchTerm
        in: query
        description: Full-text search.
        schema:
          type: string
      - name: sheets
        in: query
        description: Which sheets to include.
        schema:
          $ref: '#/components/schemas/ExportSheets'
      - name: format
        in: query
        description: Output format.
        schema:
          $ref: '#/components/schemas/ExportFileFormat'
      responses:
        '200':
          description: OK
  /v1/exports/suppliers:
    get:
      tags:
      - Exports
      summary: Export suppliers
      operationId: GET_Exports_Suppliers
      parameters:
      - name: searchTerm
        in: query
        description: Full-text search.
        schema:
          type: string
      - name: sheets
        in: query
        description: Which sheets to include.
        schema:
          $ref: '#/components/schemas/ExportSheets'
      - name: format
        in: query
        description: Output format.
        schema:
          $ref: '#/components/schemas/ExportFileFormat'
      responses:
        '200':
          description: OK
  /v1/exports/expensesbook:
    get:
      tags:
      - Exports
      summary: Export the expenses accounting register
      operationId: GET_Exports_ExpensesBook
      parameters:
      - name: from
        in: query
        description: Start date (inclusive).
        schema:
          type: string
          format: date
      - name: to
        in: query
        description: End date (inclusive).
        schema:
          type: string
          format: date
      - name: sheets
        in: query
        description: Which sheets to include.
        schema:
          $ref: '#/components/schemas/ExportSheets'
      - name: format
        in: query
        description: Output format.
        schema:
          $ref: '#/components/schemas/ExportFileFormat'
      responses:
        '200':
          description: OK
  /v1/exports/receiptsbook:
    get:
      tags:
      - Exports
      summary: Export the receipts accounting register
      operationId: GET_Exports_ReceiptsBook
      parameters:
      - name: from
        in: query
        description: Start date (inclusive).
        schema:
          type: string
          format: date
      - name: to
        in: query
        description: End date (inclusive).
        schema:
          type: string
          format: date
      - name: sheets
        in: query
        description: Which sheets to include.
        schema:
          $ref: '#/components/schemas/ExportSheets'
      - name: format
        in: query
        description: Output format.
        schema:
          $ref: '#/components/schemas/ExportFileFormat'
      responses:
        '200':
          description: OK
  /v1/exports/banktransactions/{id}:
    get:
      tags:
      - Exports
      summary: Export bank transactions for a specific account
      operationId: GET_Exports_BankTransactions
      parameters:
      - name: id
        in: path
        description: Bank account ID.
        required: true
        schema:
          type: integer
          format: int32
      - name: from
        in: query
        description: Start date (inclusive).
        schema:
          type: string
          format: date
      - name: to
        in: query
        description: End date (inclusive).
        schema:
          type: string
          format: date
      - name: sheets
        in: query
        description: Which sheets to include.
        schema:
          $ref: '#/components/schemas/ExportSheets'
      - name: format
        in: query
        description: Output format.
        schema:
          $ref: '#/components/schemas/ExportFileFormat'
      responses:
        '200':
          description: OK
  /v1/exports/expensecharges:
    get:
      tags:
      - Exports
      summary: Export purchase invoices (expense charges)
      operationId: GET_Exports_ExpenseCharges
      parameters:
      - name: from
        in: query
        description: Start date (inclusive).
        schema:
          type: string
          format: date
      - name: to
        in: query
        description: End date (inclusive).
        schema:
          type: string
          format: date
      - name: supplierId
        in: query
        description: Filter by supplier ID.
        schema:
          type: integer
          format: int32
      - name: searchTerm
        in: query
        description: Full-text search.
        schema:
          type: string
      - name: sheets
        in: query
        description: Which sheets to include.
        schema:
          $ref: '#/components/schemas/ExportSheets'
      - name: format
        in: query
        description: Output format.
        schema:
          $ref: '#/components/schemas/ExportFileFormat'
      responses:
        '200':
          description: OK
  /v1/exports/expensereports:
    get:
      tags:
      - Exports
      summary: Export expense reports
      operationId: GET_Exports_ExpenseReports
      parameters:
      - name: from
        in: query
        description: Start date (inclusive).
        schema:
          type: string
          format: date
      - name: to
        in: query
        description: End date (inclusive).
        schema:
          type: string
          format: date
      - name: colleagueId
        in: query
        description: Filter by colleague ID.
        schema:
          type: integer
          format: int32
      - name: sheets
        in: query
        description: Which sheets to include.
        schema:
          $ref: '#/components/schemas/ExportSheets'
      - name: format
        in: query
        description: Output format.
        schema:
          $ref: '#/components/schemas/ExportFileFormat'
      responses:
        '200':
          description: OK
  /v1/exports/settlements:
    get:
      tags:
      - Exports
      summary: Export settlements (customer receipts, supplier payments, colleague repayments).
      operationId: GET_Exports_Settlements
      parameters:
      - name: from
        in: query
        description: Start date (inclusive).
        schema:
          type: string
          format: date
      - name: to
        in: query
        description: End date (inclusive).
        schema:
          type: string
          format: date
      - name: sheets
        in: query
        description: Which sheets to include.
        schema:
          $ref: '#/components/schemas/ExportSheets'
      - name: format
        in: query
        description: Output format.
        schema:
          $ref: '#/components/schemas/ExportFileFormat'
      responses:
        '200':
          description: OK
  /v1/exports/commitments:
    get:
      tags:
      - Exports
      summary: Export commitments / due dates (customer, supplier, colleague).
      operationId: GET_Exports_Commitments
      parameters:
      - name: from
        in: query
        description: Start date (inclusive).
        schema:
          type: string
          format: date
      - name: to
        in: query
        description: End date (inclusive).
        schema:
          type: string
          format: date
      - name: sheets
        in: query
        description: Which sheets to include.
        schema:
          $ref: '#/components/schemas/ExportSheets'
      - name: format
        in: query
        description: Output format.
        schema:
          $ref: '#/components/schemas/ExportFileFormat'
      responses:
        '200':
          description: OK
components:
  schemas:
    ExportSheets:
      enum:
      - Summary
      - Detail
      - Analysis
      - All
      type: string
      description: Sheets to include in the export.
    ExportFileFormat:
      enum:
      - Excel
      - EuropeanCsv
      - AmericanCsv
      - Tsv
      - Json
      - Markdown
      type: string
      description: Output file format.
  securitySchemes:
    ApiKey:
      type: apiKey
      description: 'API KEY generated in application. Example: "X-API-KEY: {apiKey}"'
      name: X-API-KEY
      in: header