🎉 Introducing comments on journal entries.

API operations added

• You can now add, list, fetch, update and delete comments on journal entries.

🎉 Introducing tag management and journal entry tagging, new reference fields for invoices and credit notes, and additional invoice and item improvements.

API operations added

• You can now create, list, fetch, update, and delete tag groups to organise your tags. Within a tag group, you can also add, update, and remove individual tags.
• It is now possible to apply tags to journal entries at the journal entry level (on the journal entry) or at the journal entry item level (on individual line items). You can also update the tags on an existing journal entry. This is currently a preview feature.

API improvements

• It is now possible to create a paymentServiceFee type settlement for an invoice. This enables recording payment service fee deductions directly on the invoice.
• dueDate is now optional when creating or updating an invoice. If omitted, the due date is automatically calculated from the customer's payment terms.
• projectReference, buyerReference, and contractReference are now available on invoices. These fields can be set when creating or updating an invoice and are returned when fetching invoices.
• projectReference, buyerReference, and contractReference are now available on credit notes. These fields can be set when updating a credit note and are returned when fetching credit notes.
• bookkeepingAccountNumber is now supported on items. You can set it when creating or updating an item, and it is returned when fetching items.

🎉 Releasing new operations for PDF downloads, invoice deletion, and enhancements across invoices, credit notes, and journal entries.

API operations added

• You can now download an invoice as PDF. The invoice must be in published status.
• You can now download a credit note as PDF. The credit note must be in published status.
• It is now possible to delete a draft invoice. Only invoices in draft status can be deleted.
• It is now possible to delete a draft credit note. Only draft credit notes can be deleted.

API improvements

• paymentReference (OCR number) is now available when fetching invoices. The value is populated when the invoice is published.
• It is now possible to create journal entries with a transaction date up to 2 business days ahead.
• Fixed an issue where deleting an invoice payment could fail when it was not the last payment on the invoice.
• Legacy scopes have been sunset. All integrations should use the v1 scopes introduced in August 2025.

🎉 Releasing enhancements for the company API

API improvements

• It now possible to include contact details when creating & updating an invoice through the API
• When fetching invoices & credit notes, contact details are included if available.
• It is now possible to define the country subdivision when creating customers.

🎉 Releasing enhancements for the company API and general API

API operations added

• It is now possible to fetch information about a company.
• It is possible to disconnect a tenant using delete connection.
• It is now possible to get a connections details by Id

🎉 Releasing further enhancements for streamlined invoice reconciliation 🎉

API operations added

• It is now possible to fetch the chart of accounts for the company.
• You can fetch a specific account with additional details.
• It is now possible to record invoices, settlements, credit notes and invoice payments. The response body of record endpoint contains reference to the journal entry.

API improvements

• We have added support for image/jpeg content type through uploads and invoice attachment.

🎉 Releasing major enhancements for streamlined invoice management and reconciliation 🎉

API operations added

• It is now possible to publish a draft invoice, making it official and ready to be sent to the customer.
• You can publish, list, fetch and update credit notes for the company.
• You can now create a draft credit note for a specific invoice. The draft can be partially credited, for example, crediting 3 out of 4 items on a line. Once ready, the credit note can be published too.
• You can now create a new payment record for a specific invoice. To use an accounting account other than the default (1930), specify it via the bookkeepingAccountNumber field. You can also get all payment records for an invoice or fetch a specific one. It is also possible to delete a specific invoice payment.
• It is now possible to create a settlement that will reduce the outstanding amount of the invoice. A negative amount will increase the outstanding amount. For example, in the case of a currency gain. Settlement types that can be created in Bokio API are currency and bankFee. You can also get all settlements for an invoice or fetch a specific one. It is also possible to delete a specific settlement.

API improvements

• When adding line items to an invoice, it is possible to add bookkeeping account number to manage bookkeeping for each item efficiently.

Releasing a large set of API changes and announcing the release of v1.

🎉

Announcing Bokio API V1

We've reached a significant milestone and are excited to announce the official release of Bokio API v1! This new version brings major improvements and new features, marking the end of our beta phase.

Please note that;

• Bokio API Beta is now deprecated and will be removed on October 1st
• Private integrations must get a new API token from API Tokens

Deprecation of the Beta Version

Please be aware that the beta API is now deprecated and will be sunset on October 1st. We encourage all developers to migrate to the new v1 API as soon as possible to avoid any service disruptions.

Important Changes for Integrations

API Versioning

To ensure a smooth transition and future updates, please take a moment to review our API versioning information.

New Scopes

We've introduced new scopes to the API. This allows you to grant your integrations only the specific permissions they need, improving security and control. You can find more details on these new scopes in the API documentation.

New Tokens for Private Integrations

If you have a private integration, you must generate and copy a new API token to remain valid. While your old token may still work for a short time, it will soon return 403 responses. Please update your token to ensure your integration continues to function correctly. Go to API Tokens and use the Copy button to get a new token.

New Functionality and Exposed Data

This release includes a wealth of new features and data to enhance your integrations:

Filtering and Metadata

• Filtering: You can now use filtering in list operations, giving you more precise control over the data you retrieve.
• Metadata: We've started adding metadata for API resources, beginning with invoices. This allows for more flexible and detailed data handling.

More Data Exposed

• Invoices: Invoices now support the cash invoice type. You can also set orderNumberReference and deliveryAddress.
• Fiscal Years: It's now possible to retrieve fiscal years directly through the API.
• SIE Files: You can now download SIE files programmatically.

We have released improvements to the error handling in the Bokio API. The main changes is for validation errors where we now:

• Return all validations errors instead of first encountered error
• Validations errors include both a message and a field parameter. We want to highlight that the field parameter used the JSON Pointer which make it possible for you to identify which field within nested objects and/or array that the error is for. For example, the quantity on the second line item using #/lineitems/1/quantity.

To read more, please checkout Errors.

Releasing capability to manage attachments on invoices.

API operations added

• POST companies/{companyId}/invoices/{invoiceId}/attachments - Add an attachment to an invoice
• GET companies/{companyId}/invoices/{invoiceId}/attachments - Get attachments
• GET companies/{companyId}/invoices/{invoiceId}/attachments/{attachmentId} - Get an attachment
• DELETE companies/{companyId}/invoices/{invoiceId}/attachments/{attachmentId - Delete an attachment from an invoice
• GET /companies/{companyId}/invoices/{invoiceId}/attachments/{attachmentId}/download - Download an attachment from an invoice

API Improvements

• On Get invoices and Get an invoice the response body contains reference list to attachments on the invoice.
• Payment terms are now available on Create a customer, Get customers, Get a customer and Update a customer