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

Publishing documentation to public integrations and General API. Also releasing improvements to invoices and customer operations.

🎉

Public Integrations and General API

We are now unveiling some documentation for public integrations and the General API. There's no general access to public integrations at this point but we enable early access for key integration partnerships.

Please reach out to [email protected] if you are interested.

API Improvements

• It's now possible to create customers by only supplying the name of the customer. Note that before invoices are published additional information is required.
• The issue with invoice dates and customer payment terms, mentioned in 2025-04-11, has now been solved.

API specifications available for download

Finally, we are making api specification available for download.

• Specification for Company API
• Specification for General API

Release to introduce Items and use of items on invoices as well as some smaller improvements to invoices.

🎉

Introducing Items

We have improved invoicing by making it possible to manage Items and reference them on invoice lineItems

API Improvements

• unitType is now available on Invoice lineItems
• itemRef add to invoice lineItems to use value from the Item

API operations added

• POST companies/{companyId}/items - Create an item
• GET companies/{companyId}/items - Get all items
• GET companies/{companyId}/items/{itemId} - Get an item
• PUT companies/{companyId}/items/{itemId} - Update an item
• DELETE companies/{companyId}/items/{itemId} - Remove an item

Known issues

Issue with invoice dates and customer payment terms

There's an issue with invoice dates that makes the dates change when opening an invoice, created through the Bokio API, in the app. The dates will when invoice is opened in the app changes to the match the customer payment terms. We are actively working on a fix for this issue and hope to resolve it soon.

Releasing API for reversing journal entries, enhanced uploads actions, and manage invoices.

🎉

Invoices available in Beta

Many of you requested invoices in API. Today we are making it available in the Beta.

⚠️

Beta breaking changes

journalentries is now journal-entries to improve reading and follow a consistent url format.

API Improvements

• By setting journalEntryId on POST companies/{companyId}/upload it's now possible to connect an upload with a journal entry.

API operations added:

• POST companies/{companyId}/journal-entries/{journalEntryId}/reverse - Reverse a journal entry
• GET companies/{companyId}/uploads - Get all uploads
• GET companies/{companyId}/uploads/{uploadId} - Get an upload
• POST companies/{companyId}/uploads/{uploadId}/download - Download an upload
• POST companies/{companyId}/invoices - Create an invoice
• GET companies/{companyId}/invoices - Get all invoices
• GET companies/{companyId}/invoices/{invoiceId} - Get an invoice
• PUT companies/{companyId}/invoices/{invoiceId} - Update an invoice
• POST companies/{companyId}/Invoices/{invoiceId}/line-items - Add a line item to an invoice

Releasing API improvements and support for managing customers.

⚠️

Beta breaking changes

POST companies/{companyId}/uploads has been changed to take multipart/form-data. For more details, see Add an upload to bokio.

API operations added:

• POST companies/{companyId}/customers - Create a customer
• GET companies/{companyId}/customers - Get all customers
• GET companies/{companyId}/customers/{customerId} - Get a customer
• PUT companies/{companyId}/customers/{customerId} - Update a customer
• DELETE companies/{companyId}/customers/{customerId} - Delete a customer

Introducing Bokio API as a Beta for Private Integrations. Please take note of breaking changes may need to be introduce without notice during the Beta.

Checkout: How to set up integration with a company in Bokio via an API to get started

API operations included:

• POST companies/{companyId}/journalentries
• GET companies/{companyId}/journalentries
• GET companies/{companyId}/journalentries/{journalId}
• POST companies/{companyId}/uploads