{ "info": { "_postman_id": "d390f058-c66c-4b2e-8fb9-0c77a3688c45", "name": "Company authorization invoices API", "description": "The Bokio Company API containing all resources for company tenant.\n\nContact Support:\n Name: Bokio\n Email: support@bokio.se", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T01:15:37.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "lastUpdatedBy": "35240", "uid": "35240-d390f058-c66c-4b2e-8fb9-0c77a3688c45" }, "item": [ { "name": "companies", "item": [ { "name": "{companyId}", "item": [ { "name": "invoices", "item": [ { "name": "{invoiceId}", "item": [ { "name": "attachments", "item": [ { "name": "{attachmentId}", "item": [ { "name": "download", "item": [ { "name": "Download an attachment from an invoice", "id": "778ad136-35ed-4d5b-bd24-8440b594dcd7", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/octet-stream" } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/attachments/:attachmentId/download", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "attachments", ":attachmentId", "download" ], "variable": [ { "id": "75978635-749a-45be-9bf1-00b7094e90ea", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "572be831-b7d7-46b6-9a5a-a96c7bb570cb", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" }, { "id": "4215e964-b7c8-4dab-ab07-03075121a463", "key": "attachmentId", "value": "", "description": "(Required) Unique identifier of the attachment" } ] }, "description": "Download the attachment with the matching attachmentId.\n\n**Scope:** `invoices:read`\n" }, "response": [ { "id": "709ad4a0-5cfa-49fa-aee9-37f2d41d6afc", "name": "Attachment found and downloaded successfully.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/octet-stream" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/attachments/:attachmentId/download", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "attachments", ":attachmentId", "download" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" }, { "key": "attachmentId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [ { "key": "Content-Type", "value": "application/octet-stream" } ], "cookie": [], "responseTime": null, "body": "", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-709ad4a0-5cfa-49fa-aee9-37f2d41d6afc" }, { "id": "b2e7886a-0f55-4ce2-966c-1c9dddb71754", "name": "Attachment not found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/attachments/:attachmentId/download", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "attachments", ":attachmentId", "download" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" }, { "key": "attachmentId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-b2e7886a-0f55-4ce2-966c-1c9dddb71754" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-778ad136-35ed-4d5b-bd24-8440b594dcd7" } ], "id": "e5a5f635-2c43-44d8-b2d7-98f95cb21c74", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-e5a5f635-2c43-44d8-b2d7-98f95cb21c74" }, { "name": "Get an attachment", "id": "5dbe4d97-38aa-40c2-bbf9-029c4a4b5bfc", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/attachments/:attachmentId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "attachments", ":attachmentId" ], "variable": [ { "id": "76fa687b-90b3-4d32-8951-973b26596afc", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "4df8912a-867b-4fa2-bf72-f1abd2ff9cb0", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" }, { "id": "cc7d922f-2388-4f42-b705-da231258303c", "key": "attachmentId", "value": "", "description": "(Required) Unique identifier of the attachment" } ] }, "description": "Retrieve the information of the attachment with the matching attachmentId.\n\n**Scope:** `invoices:read`\n" }, "response": [ { "id": "86b44852-a575-440a-abd3-6d142b9f2820", "name": "Attachment found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/attachments/:attachmentId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "attachments", ":attachmentId" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" }, { "key": "attachmentId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"invoiceId\": \"\",\n \"fileName\": \"\"\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-86b44852-a575-440a-abd3-6d142b9f2820" }, { "id": "c6c12c68-b69b-4ce7-8e86-0ec5771deff0", "name": "Attachment not found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/attachments/:attachmentId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "attachments", ":attachmentId" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" }, { "key": "attachmentId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-c6c12c68-b69b-4ce7-8e86-0ec5771deff0" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-5dbe4d97-38aa-40c2-bbf9-029c4a4b5bfc" }, { "name": "Delete an attachment from an invoice", "id": "e6786462-c28a-435d-b5cd-cb196e1d00c8", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/attachments/:attachmentId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "attachments", ":attachmentId" ], "variable": [ { "id": "54025e14-9ac5-4f4d-b6b7-a59f91bc5663", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "1e1def5f-d73d-4dd3-bc1e-4e232011e503", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" }, { "id": "79e112ec-771b-4abd-a7b9-289553f9ba5b", "key": "attachmentId", "value": "", "description": "(Required) Unique identifier of the attachment" } ] }, "description": "Deletes an attachment from an existing draft invoice.\n\n**NOTE:** The invoice must be in draft status.\n\n**Scope:** `invoices:write`\n" }, "response": [ { "id": "3a9cfd5a-8020-425b-ac54-de9203505e46", "name": "Attachment deleted from invoice", "originalRequest": { "method": "DELETE", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/attachments/:attachmentId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "attachments", ":attachmentId" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" }, { "key": "attachmentId" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-3a9cfd5a-8020-425b-ac54-de9203505e46" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-e6786462-c28a-435d-b5cd-cb196e1d00c8" } ], "id": "379f81cf-05a3-4f31-b396-d46f08be7611", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-379f81cf-05a3-4f31-b396-d46f08be7611" }, { "name": "Add an attachment to an invoice", "id": "b8bb4b42-1495-4693-97b5-8557bee49142", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "formdata", "formdata": [ { "description": "(Required) The file to attach to invoice", "key": "file", "type": "file", "value": null } ] }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/attachments", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "attachments" ], "variable": [ { "id": "506df6f5-9c72-4171-9269-83a80506509f", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "d19e186a-8f8d-42e0-a358-304e6097ec2f", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" } ] }, "description": "Adds an attachment to an existing draft invoice. The attachment will be added last in the list of attachments on the invoice.\nAttached files will appear as additional pages in the final invoice\n\nSupported file types: jpeg, png and pdf\n\nShow example of multipart MIME as we do for uploads\n\n**NOTE:** The invoice must be in draft status.\nMaximum file size is 4 MB and all files can't exceed 10 MB.\nDimensions must be less than height of 7016 and width of 4960 in pixels\n\n**Scope:** `invoices:write`\n" }, "response": [ { "id": "a069db93-28e8-4b5e-92b2-34d5e58e8312", "name": "Attachment added to invoice", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "formdata", "formdata": [ { "description": "(Required) The file to attach to invoice", "key": "file", "type": "file" } ] }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/attachments", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "attachments" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"invoiceId\": \"\",\n \"fileName\": \"\"\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-a069db93-28e8-4b5e-92b2-34d5e58e8312" }, { "id": "20f1f686-0b69-47a7-a803-16dbe644bb4e", "name": "Missing required information", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "formdata", "formdata": [ { "description": "(Required) The file to attach to invoice", "key": "file", "type": "file" } ] }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/attachments", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "attachments" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-20f1f686-0b69-47a7-a803-16dbe644bb4e" }, { "id": "ac2eae4b-03a0-455c-85f6-41224358476d", "name": "The requested resource was not found", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "formdata", "formdata": [ { "description": "(Required) The file to attach to invoice", "key": "file", "type": "file" } ] }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/attachments", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "attachments" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-ac2eae4b-03a0-455c-85f6-41224358476d" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-b8bb4b42-1495-4693-97b5-8557bee49142" }, { "name": "Get attachments", "id": "e7197656-0513-4b52-91e2-46a1a7e318ef", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/attachments?page=1&pageSize=25&query=", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "attachments" ], "query": [ { "description": "Page number", "key": "page", "value": "1" }, { "description": "Number of items per page", "key": "pageSize", "value": "25" }, { "description": "Optional query to filter the data set with supported fields listed below and [available operations](filtering).\n\n| Field | Type |\n| ------------------------- | ----------- |\n| fileName | string |\n", "key": "query", "value": "" } ], "variable": [ { "id": "3acbaa73-f39b-4497-bc0c-b52480ef17dd", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "73490cb9-74dd-450f-ab30-122505a42e89", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" } ] }, "description": "Retrieve the information of the attachments for the invoice. Use the query parameters to filter and navigate through the results.\n\n**Scope:** `invoices:read`\n" }, "response": [ { "id": "1f6f5882-e3a9-49bd-b151-73b83d31d1b5", "name": "Attachments found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/attachments?page=1&pageSize=25&query=", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "attachments" ], "query": [ { "description": "Page number", "key": "page", "value": "1" }, { "description": "Number of items per page", "key": "pageSize", "value": "25" }, { "description": "Optional query to filter the data set with supported fields listed below and [available operations](filtering).\n\n| Field | Type |\n| ------------------------- | ----------- |\n| fileName | string |\n", "key": "query", "value": "" } ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"totalItems\": \"\",\n \"totalPages\": \"\",\n \"currentPage\": \"\",\n \"items\": [\n {\n \"id\": \"\",\n \"invoiceId\": \"\",\n \"fileName\": \"\"\n },\n {\n \"id\": \"\",\n \"invoiceId\": \"\",\n \"fileName\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-1f6f5882-e3a9-49bd-b151-73b83d31d1b5" }, { "id": "1c6a4b14-d9d1-4a0b-8b3c-42af395bd3c2", "name": "The requested resource was not found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/attachments?page=1&pageSize=25&query=", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "attachments" ], "query": [ { "description": "Page number", "key": "page", "value": "1" }, { "description": "Number of items per page", "key": "pageSize", "value": "25" }, { "description": "Optional query to filter the data set with supported fields listed below and [available operations](filtering).\n\n| Field | Type |\n| ------------------------- | ----------- |\n| fileName | string |\n", "key": "query", "value": "" } ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-1c6a4b14-d9d1-4a0b-8b3c-42af395bd3c2" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-e7197656-0513-4b52-91e2-46a1a7e318ef" } ], "id": "8e3e471d-8e11-468c-9885-cfc685312d42", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-8e3e471d-8e11-468c-9885-cfc685312d42" }, { "name": "credit", "item": [ { "name": "Create a credit note", "id": "222f3f2f-8b9a-46e7-983e-a67f44ac93c4", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/credit", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "credit" ], "variable": [ { "id": "f32c77cd-4ebe-424d-9de2-089666cb19c6", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "eee33008-554f-46a7-9266-bc0c58e95662", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" } ] }, "description": "Creates a draft credit note for the specified invoice and returns the created credit note draft.\n\n- Use `PUT /credit-notes/{id}` in case the invoice should be partially credited, e.g 3 out of a quantity of 4 for a line item.\n- Use `POST /credit-notes/{id}/publish` to publish the created credit note.\n\n**Scope:** `invoices:write`\n" }, "response": [ { "id": "8c5e1e26-a688-430b-b358-9c7289336eac", "name": "Credit note created successfully, returns the updated invoice with creditNoteRef", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/credit", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "credit" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"currency\": \"SEK\",\n \"creditDate\": \"\",\n \"dueDate\": \"\",\n \"lineItems\": [\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"services\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rutWaterWashingOfTextiles\"\n }\n },\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"services\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rutCleaning\"\n }\n }\n ],\n \"invoiceRef\": {\n \"id\": \"\",\n \"invoiceNumber\": \"\"\n },\n \"customerRef\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"contactDetailRef\": {\n \"id\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n },\n \"invoiceNumber\": \"\",\n \"orderNumberReference\": \"\",\n \"projectReference\": \"\",\n \"buyerReference\": \"\",\n \"contractReference\": \"\",\n \"currencyRate\": 1,\n \"totalAmount\": \"\",\n \"totalTax\": \"\",\n \"paidAmount\": \"\",\n \"status\": \"draft\",\n \"publishedDateTime\": \"\",\n \"billingAddress\": {\n \"line1\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\",\n \"line2\": \"\",\n \"countrySubdivision\": \"\"\n },\n \"deliveryAddress\": {\n \"line1\": \"\",\n \"line2\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\"\n },\n \"attachmentRefs\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"journalEntryRef\": {\n \"id\": \"\"\n },\n \"metadata\": {\n \"elit_f7e\": \"\",\n \"laboreed5\": \"\",\n \"adipisicingb\": \"\",\n \"sit_23\": \"\",\n \"tempor_9\": \"\",\n \"exercitation1c5\": \"\",\n \"ex_0_\": \"\",\n \"occaecat3a\": \"\",\n \"eiusmodca\": \"\"\n }\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-8c5e1e26-a688-430b-b358-9c7289336eac" }, { "id": "ff1c7d27-f44a-4817-a3a3-84252a851492", "name": "Invalid request or credit note cannot be created", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/credit", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "credit" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-ff1c7d27-f44a-4817-a3a3-84252a851492" }, { "id": "7ad58667-b194-4406-90ad-edbe031a57e9", "name": "Invoice not found", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/credit", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "credit" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-7ad58667-b194-4406-90ad-edbe031a57e9" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-222f3f2f-8b9a-46e7-983e-a67f44ac93c4" } ], "id": "b7d57fdb-c9ea-4010-9dc6-957e3bd9729a", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-b7d57fdb-c9ea-4010-9dc6-957e3bd9729a" }, { "name": "download", "item": [ { "name": "Download an invoice", "id": "62208ea2-1912-4767-bce6-a3bae0eafbd6", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/pdf" } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/download", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "download" ], "variable": [ { "id": "2ec7ef10-5064-4dae-9ce8-6468588a75a3", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "15227f3f-a56e-49d9-a1e2-82778f509273", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" } ] }, "description": "Download the invoice PDF with the matching invoiceId.\n\n**NOTE:** The invoice must be in published status.\n\n**Scope:** `invoices:read`\n" }, "response": [ { "id": "4adca71a-3e00-4663-a3af-50d5bc2ad455", "name": "Invoice found and downloaded successfully.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/pdf" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/download", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "download" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [ { "key": "Content-Type", "value": "application/pdf" } ], "cookie": [], "responseTime": null, "body": "", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-4adca71a-3e00-4663-a3af-50d5bc2ad455" }, { "id": "0df24b56-45e2-4ee4-bd11-7eb840c504b2", "name": "Invoice is not in a published status", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/download", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "download" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-0df24b56-45e2-4ee4-bd11-7eb840c504b2" }, { "id": "352b1ddd-9166-4ed1-a8ff-7636e7071aef", "name": "Invoice not found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/download", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "download" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-352b1ddd-9166-4ed1-a8ff-7636e7071aef" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-62208ea2-1912-4767-bce6-a3bae0eafbd6" } ], "id": "66880c6a-9d98-4ce8-864a-46c6a5cd8770", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-66880c6a-9d98-4ce8-864a-46c6a5cd8770" }, { "name": "line-items", "item": [ { "name": "Add a line item to an invoice", "id": "ccd5a852-031a-4860-ae10-d5e88384e8be", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rotPainting\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/line-items", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "line-items" ], "variable": [ { "id": "eb2b0edb-42a3-4369-a509-29a228f97f00", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "29b4f0f4-5a79-4bad-a160-3f0f8db9a02e", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" } ] }, "description": "Adds a line item to an existing draft invoice. The item will be added last in the list of line items on the invoice.\n\n**NOTE:** The invoice must be in draft status.\n\n**Scope:** `invoices:write`\n" }, "response": [ { "id": "f2e195c8-e81d-4de6-abe7-c03bb80a6356", "name": "Line item added", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rotPainting\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/line-items", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "line-items" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rotPainting\"\n }\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-f2e195c8-e81d-4de6-abe7-c03bb80a6356" }, { "id": "b915d0ab-626b-4a83-a3e2-876807b74c30", "name": "Missing required information", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rotPainting\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/line-items", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "line-items" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-b915d0ab-626b-4a83-a3e2-876807b74c30" }, { "id": "f5842743-67a1-4bbb-a4ff-502109fb7323", "name": "Invoice not found", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rotPainting\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/line-items", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "line-items" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-f5842743-67a1-4bbb-a4ff-502109fb7323" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-ccd5a852-031a-4860-ae10-d5e88384e8be" } ], "id": "c061ea15-d586-4fe5-a11c-affd7a1125df", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-c061ea15-d586-4fe5-a11c-affd7a1125df" }, { "name": "payments", "item": [ { "name": "{paymentId}", "item": [ { "name": "record", "item": [ { "name": "Record an invoice payment", "id": "fb55627b-66b1-4cf6-9dd8-7a2d0e2d38ce", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/payments/:paymentId/record", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "payments", ":paymentId", "record" ], "variable": [ { "id": "b446c04d-a9be-4e8c-bcc2-b6036e66248b", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "3afd74db-9705-4f17-a202-20a055aaf5a8", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" }, { "id": "104bce57-e243-4347-8dde-53b964f36d60", "key": "paymentId", "value": "", "description": "(Required) Unique identifier of the invoice payment" } ] }, "description": "Record an invoice payment.\n\n**Scope:** `invoices:write`\n" }, "response": [ { "id": "4c4f8129-eb96-41c4-83c2-52ec3af5b604", "name": "Invoice payment recorded successfully", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/payments/:paymentId/record", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "payments", ":paymentId", "record" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" }, { "key": "paymentId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"date\": \"\",\n \"sumBaseCurrency\": \"\",\n \"bookkeepingAccountNumber\": \"\",\n \"id\": \"\",\n \"invoiceId\": \"\",\n \"journalEntryRef\": {\n \"id\": \"\"\n }\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-4c4f8129-eb96-41c4-83c2-52ec3af5b604" }, { "id": "371f5690-a3e2-429e-9b00-0d224cdc233d", "name": "Invalid request or invoice payment cannot be recorded", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/payments/:paymentId/record", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "payments", ":paymentId", "record" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" }, { "key": "paymentId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-371f5690-a3e2-429e-9b00-0d224cdc233d" }, { "id": "1190141f-2472-4945-b968-9f0ad4707a6b", "name": "Invoice payment not found", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/payments/:paymentId/record", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "payments", ":paymentId", "record" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" }, { "key": "paymentId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-1190141f-2472-4945-b968-9f0ad4707a6b" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-fb55627b-66b1-4cf6-9dd8-7a2d0e2d38ce" } ], "id": "94616837-27d5-4499-b5a0-4e4265d80037", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-94616837-27d5-4499-b5a0-4e4265d80037" }, { "name": "Get an invoice payment", "id": "f67fc2c0-03ea-435f-a3fb-ad90e7eb16eb", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/payments/:paymentId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "payments", ":paymentId" ], "variable": [ { "id": "4194a800-9666-4e22-83c0-73aedaf1451e", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "b4b0c6eb-f262-4b15-9c7f-256f58a751e9", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" }, { "id": "d3ddf03f-f8fb-4796-b1ea-0794d7e16f80", "key": "paymentId", "value": "", "description": "(Required) Unique identifier of the payment" } ] }, "description": "Retrieves a specific payment record for the invoice.\n\n**Scope:** `invoices:read`\n" }, "response": [ { "id": "b1def7f8-b95a-464d-94ef-43cdfec1f3e6", "name": "Payment found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/payments/:paymentId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "payments", ":paymentId" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" }, { "key": "paymentId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"date\": \"\",\n \"sumBaseCurrency\": \"\",\n \"bookkeepingAccountNumber\": \"\",\n \"id\": \"\",\n \"invoiceId\": \"\",\n \"journalEntryRef\": {\n \"id\": \"\"\n }\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-b1def7f8-b95a-464d-94ef-43cdfec1f3e6" }, { "id": "4e29c8ff-ee4b-4b92-baf8-25a8d65e0152", "name": "Invoice or payment not found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/payments/:paymentId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "payments", ":paymentId" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" }, { "key": "paymentId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-4e29c8ff-ee4b-4b92-baf8-25a8d65e0152" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-f67fc2c0-03ea-435f-a3fb-ad90e7eb16eb" }, { "name": "Delete an invoice payment", "id": "63fc224f-ebfd-4f36-8e09-84d50b5f5e29", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/payments/:paymentId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "payments", ":paymentId" ], "variable": [ { "id": "e0484796-6afc-43f4-8665-9586949d1f8f", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "9004eb64-4433-4f23-ba14-d82aa6c0a110", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" }, { "id": "3bd62503-20b8-4a20-b101-05eee98ffb17", "key": "paymentId", "value": "", "description": "(Required) Unique identifier of the payment" } ] }, "description": "Deletes a payment record for the invoice.\n\n**Scope:** `invoices:write`\n" }, "response": [ { "id": "b1e9c117-589f-4a0e-a178-bce4fd192a6d", "name": "Payment deleted successfully", "originalRequest": { "method": "DELETE", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/payments/:paymentId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "payments", ":paymentId" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" }, { "key": "paymentId" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-b1e9c117-589f-4a0e-a178-bce4fd192a6d" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-63fc224f-ebfd-4f36-8e09-84d50b5f5e29" } ], "id": "838110d4-8055-4462-9cc6-57620a9b51b6", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-838110d4-8055-4462-9cc6-57620a9b51b6" }, { "name": "Create an invoice payment", "id": "ac041dd9-87d8-4103-9e89-e73e4bd8472b", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"date\": \"\",\n \"sumBaseCurrency\": \"\",\n \"bookkeepingAccountNumber\": \"\",\n \"id\": \"\",\n \"invoiceId\": \"\",\n \"journalEntryRef\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/payments", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "payments" ], "variable": [ { "id": "e228cd98-60a1-4851-833b-93c21b62627e", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "74cbdf43-7d4e-4c76-bd55-39e5785c7ee2", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" } ] }, "description": "Creates a new payment record for the specified invoice. Use the bookkeepingAccountNumber field to specify an accounting account other than the default account (1930).\n\n**Scope:** `invoices:write`\n" }, "response": [ { "id": "8239c257-6ef2-4bbb-89be-05c4bd7957eb", "name": "Payment created successfully", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"date\": \"\",\n \"sumBaseCurrency\": \"\",\n \"bookkeepingAccountNumber\": \"\",\n \"id\": \"\",\n \"invoiceId\": \"\",\n \"journalEntryRef\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/payments", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "payments" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"date\": \"\",\n \"sumBaseCurrency\": \"\",\n \"bookkeepingAccountNumber\": \"\",\n \"id\": \"\",\n \"invoiceId\": \"\",\n \"journalEntryRef\": {\n \"id\": \"\"\n }\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-8239c257-6ef2-4bbb-89be-05c4bd7957eb" }, { "id": "93497515-3d22-489b-8807-7e07dc314b4d", "name": "Invalid payment data", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"date\": \"\",\n \"sumBaseCurrency\": \"\",\n \"bookkeepingAccountNumber\": \"\",\n \"id\": \"\",\n \"invoiceId\": \"\",\n \"journalEntryRef\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/payments", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "payments" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-93497515-3d22-489b-8807-7e07dc314b4d" }, { "id": "9ab2db74-af30-401e-9362-39798b9e79df", "name": "Invoice not found", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"date\": \"\",\n \"sumBaseCurrency\": \"\",\n \"bookkeepingAccountNumber\": \"\",\n \"id\": \"\",\n \"invoiceId\": \"\",\n \"journalEntryRef\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/payments", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "payments" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-9ab2db74-af30-401e-9362-39798b9e79df" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-ac041dd9-87d8-4103-9e89-e73e4bd8472b" }, { "name": "Get invoice payments", "id": "bc1b53b3-e283-4a30-8963-c0d7b844612c", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/payments?page=1&pageSize=25&query=", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "payments" ], "query": [ { "description": "Page number", "key": "page", "value": "1" }, { "description": "Number of items per page", "key": "pageSize", "value": "25" }, { "description": "Optional query to filter the data set with supported fields listed below and [available operations](filtering).\n\n| Field | Type |\n| ------------------------- | ----------- |\n| date | date |\n| sumBaseCurrency | decimal |\n", "key": "query", "value": "" } ], "variable": [ { "id": "099cb351-dba4-486b-96a3-d331ae670ac0", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "cd41ee61-cad3-4e81-8ac4-5f1de5c3afe7", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" } ] }, "description": "Retrieves all payment records for the specified invoice.\n\n**Scope:** `invoices:read`\n" }, "response": [ { "id": "99cb135c-7705-4437-83de-1de6abf54e5e", "name": "Payments found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/payments?page=1&pageSize=25&query=", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "payments" ], "query": [ { "description": "Page number", "key": "page", "value": "1" }, { "description": "Number of items per page", "key": "pageSize", "value": "25" }, { "description": "Optional query to filter the data set with supported fields listed below and [available operations](filtering).\n\n| Field | Type |\n| ------------------------- | ----------- |\n| date | date |\n| sumBaseCurrency | decimal |\n", "key": "query", "value": "" } ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"totalItems\": \"\",\n \"totalPages\": \"\",\n \"currentPage\": \"\",\n \"items\": [\n {\n \"date\": \"\",\n \"sumBaseCurrency\": \"\",\n \"bookkeepingAccountNumber\": \"\",\n \"id\": \"\",\n \"invoiceId\": \"\",\n \"journalEntryRef\": {\n \"id\": \"\"\n }\n },\n {\n \"date\": \"\",\n \"sumBaseCurrency\": \"\",\n \"bookkeepingAccountNumber\": \"\",\n \"id\": \"\",\n \"invoiceId\": \"\",\n \"journalEntryRef\": {\n \"id\": \"\"\n }\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-99cb135c-7705-4437-83de-1de6abf54e5e" }, { "id": "1d4689dd-55fa-4857-acf9-4023a351823f", "name": "Invoice not found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/payments?page=1&pageSize=25&query=", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "payments" ], "query": [ { "description": "Page number", "key": "page", "value": "1" }, { "description": "Number of items per page", "key": "pageSize", "value": "25" }, { "description": "Optional query to filter the data set with supported fields listed below and [available operations](filtering).\n\n| Field | Type |\n| ------------------------- | ----------- |\n| date | date |\n| sumBaseCurrency | decimal |\n", "key": "query", "value": "" } ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-1d4689dd-55fa-4857-acf9-4023a351823f" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-bc1b53b3-e283-4a30-8963-c0d7b844612c" } ], "id": "58e8f462-1b34-459e-9666-c32151059360", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-58e8f462-1b34-459e-9666-c32151059360" }, { "name": "publish", "item": [ { "name": "Publish an invoice", "id": "4c6b7a43-0a6d-4a4c-a77d-b4544c70c79b", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/publish", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "publish" ], "variable": [ { "id": "a47e6c20-5620-4cbc-a8cc-d5ac8836fd3f", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "358bec10-9f54-41a3-8751-a1edf7a3eefe", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" } ] }, "description": "Publishes a draft invoice, making it official and ready to be sent to the customer.\nNote that invoice will not be automatically emailed to the customer when published through the API.\n\n**Scope:** `invoices:write`\n" }, "response": [ { "id": "95162dc9-8ebe-4f90-a44f-bb06447fb630", "name": "Invoice published successfully", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/publish", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "publish" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"invoiceDate\": \"\",\n \"lineItems\": [\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rutGardening\"\n }\n },\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rotPlumbing\"\n }\n }\n ],\n \"id\": \"\",\n \"type\": \"invoice\",\n \"customerRef\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"contactDetailRef\": {\n \"id\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n },\n \"invoiceNumber\": \"\",\n \"paymentReference\": \"\",\n \"orderNumberReference\": \"\",\n \"projectReference\": \"\",\n \"buyerReference\": \"\",\n \"contractReference\": \"\",\n \"currency\": \"SEK\",\n \"currencyRate\": 1,\n \"totalAmount\": \"\",\n \"totalTax\": \"\",\n \"paidAmount\": \"\",\n \"status\": \"draft\",\n \"dueDate\": \"\",\n \"publishedDateTime\": \"\",\n \"billingAddress\": {\n \"line1\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\",\n \"line2\": \"\",\n \"countrySubdivision\": \"\"\n },\n \"deliveryAddress\": {\n \"line1\": \"\",\n \"line2\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\"\n },\n \"taxReduction\": {\n \"type\": \"rut\",\n \"description\": \"\",\n \"deductionPeople\": [\n {\n \"personalNumber\": \"47447918-1313\",\n \"deductionAmount\": \"\"\n }\n ],\n \"propertyType\": \"housingDesignation\",\n \"realEstateNumber\": \"\",\n \"tenantOrgNumber\": \"\",\n \"apartmentNumber\": \"\",\n \"deductionAmount\": \"\",\n \"status\": \"readyToSubmit\"\n },\n \"attachmentRefs\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"journalEntryRef\": {\n \"id\": \"\"\n },\n \"creditNoteRefs\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"metadata\": {\n \"exercitation3\": \"\",\n \"anim91\": \"\",\n \"incididunt_6\": \"\",\n \"qui06\": \"\"\n }\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-95162dc9-8ebe-4f90-a44f-bb06447fb630" }, { "id": "d96429e9-1a98-46a9-af2c-c12eebdf7e6e", "name": "Invalid request or invoice cannot be published", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/publish", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "publish" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-d96429e9-1a98-46a9-af2c-c12eebdf7e6e" }, { "id": "91050bb2-12ed-4d24-8ba5-df0ba2a4dad9", "name": "Invoice not found", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/publish", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "publish" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-91050bb2-12ed-4d24-8ba5-df0ba2a4dad9" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-4c6b7a43-0a6d-4a4c-a77d-b4544c70c79b" } ], "id": "421868fd-0443-47ba-b0f1-42835162f19e", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-421868fd-0443-47ba-b0f1-42835162f19e" }, { "name": "record", "item": [ { "name": "Record an invoice", "id": "803676c5-fe61-45c3-bdd7-a81bc5b1023f", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/record", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "record" ], "variable": [ { "id": "9c09a974-2f59-4424-8ea7-e86669db8ec6", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "7ec6a6d0-0db7-4d4c-9e51-50a939c474f8", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" } ] }, "description": "Record an invoice.\n\n**Scope:** `invoices:write`\n" }, "response": [ { "id": "414a810b-1d07-4752-8492-df99e7def304", "name": "Invoice recorded successfully", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/record", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "record" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"invoiceDate\": \"\",\n \"lineItems\": [\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rutGardening\"\n }\n },\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rotPlumbing\"\n }\n }\n ],\n \"id\": \"\",\n \"type\": \"invoice\",\n \"customerRef\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"contactDetailRef\": {\n \"id\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n },\n \"invoiceNumber\": \"\",\n \"paymentReference\": \"\",\n \"orderNumberReference\": \"\",\n \"projectReference\": \"\",\n \"buyerReference\": \"\",\n \"contractReference\": \"\",\n \"currency\": \"SEK\",\n \"currencyRate\": 1,\n \"totalAmount\": \"\",\n \"totalTax\": \"\",\n \"paidAmount\": \"\",\n \"status\": \"draft\",\n \"dueDate\": \"\",\n \"publishedDateTime\": \"\",\n \"billingAddress\": {\n \"line1\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\",\n \"line2\": \"\",\n \"countrySubdivision\": \"\"\n },\n \"deliveryAddress\": {\n \"line1\": \"\",\n \"line2\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\"\n },\n \"taxReduction\": {\n \"type\": \"rut\",\n \"description\": \"\",\n \"deductionPeople\": [\n {\n \"personalNumber\": \"47447918-1313\",\n \"deductionAmount\": \"\"\n }\n ],\n \"propertyType\": \"housingDesignation\",\n \"realEstateNumber\": \"\",\n \"tenantOrgNumber\": \"\",\n \"apartmentNumber\": \"\",\n \"deductionAmount\": \"\",\n \"status\": \"readyToSubmit\"\n },\n \"attachmentRefs\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"journalEntryRef\": {\n \"id\": \"\"\n },\n \"creditNoteRefs\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"metadata\": {\n \"exercitation3\": \"\",\n \"anim91\": \"\",\n \"incididunt_6\": \"\",\n \"qui06\": \"\"\n }\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-414a810b-1d07-4752-8492-df99e7def304" }, { "id": "db32b9cf-3331-4196-8cb4-4efbd4b8dae4", "name": "Invalid request or invoice cannot be recorded", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/record", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "record" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-db32b9cf-3331-4196-8cb4-4efbd4b8dae4" }, { "id": "64ee6c76-b425-4bbc-8bea-98b3a69915cb", "name": "Invoice not found", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/record", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "record" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-64ee6c76-b425-4bbc-8bea-98b3a69915cb" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-803676c5-fe61-45c3-bdd7-a81bc5b1023f" } ], "id": "68fc7a1c-4d76-4cf2-88d4-b21a0b235934", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-68fc7a1c-4d76-4cf2-88d4-b21a0b235934" }, { "name": "settlements", "item": [ { "name": "{settlementId}", "item": [ { "name": "record", "item": [ { "name": "Record an invoice settlement", "id": "32227ab5-e21c-4159-90ab-274b6c2722b2", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/settlements/:settlementId/record", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "settlements", ":settlementId", "record" ], "variable": [ { "id": "b71ce731-ff61-4da2-bf64-5ccdb47b48be", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "af44c395-48a0-489b-947d-ba278c33d800", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" }, { "id": "dff5b5c2-daa1-4411-8772-e6b09b125034", "key": "settlementId", "value": "", "description": "(Required) Unique identifier of the invoice settlement" } ] }, "description": "Record an invoice settlement.\n\n**Scope:** `invoices:write`\n" }, "response": [ { "id": "52099ce0-891c-42d3-827a-ae25ae1a1011", "name": "Invoice settlement recorded successfully", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/settlements/:settlementId/record", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "settlements", ":settlementId", "record" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" }, { "key": "settlementId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"invoiceId\": \"\",\n \"type\": \"bankFee\",\n \"invoiceSettlementDetails\": {\n \"date\": \"\",\n \"sumBaseCurrency\": \"\"\n },\n \"journalEntryRef\": {\n \"id\": \"\"\n }\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-52099ce0-891c-42d3-827a-ae25ae1a1011" }, { "id": "20a69e46-2d79-4156-8acf-9bc41ced5c57", "name": "Invalid request or invoice settlement cannot be recorded", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/settlements/:settlementId/record", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "settlements", ":settlementId", "record" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" }, { "key": "settlementId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-20a69e46-2d79-4156-8acf-9bc41ced5c57" }, { "id": "0f306fa0-695a-468e-9e82-15a45bd58c85", "name": "Invoice settlement not found", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/settlements/:settlementId/record", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "settlements", ":settlementId", "record" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" }, { "key": "settlementId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-0f306fa0-695a-468e-9e82-15a45bd58c85" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-32227ab5-e21c-4159-90ab-274b6c2722b2" } ], "id": "813db87d-7786-4c6e-983a-6efece92aeb8", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-813db87d-7786-4c6e-983a-6efece92aeb8" }, { "name": "Get an invoice settlement", "id": "8a2806bf-d7a2-4d5a-accd-0b0e6fb78c70", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/settlements/:settlementId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "settlements", ":settlementId" ], "variable": [ { "id": "3127ba34-206d-487a-be81-d2eeca063df2", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "d4a61426-f42a-4238-a226-0bfe4d3a8428", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" }, { "id": "842b5b30-17fb-45ef-b624-1fdacfc0f4d8", "key": "settlementId", "value": "", "description": "(Required) Unique identifier of the settlement" } ] }, "description": "Retrieve the information of the specific settlement with the matching settlementId.\n\n**Scope:** `invoices:read`\n" }, "response": [ { "id": "8511788f-30b2-4dc3-8dc0-50b44d9c2e2c", "name": "Settlement", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/settlements/:settlementId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "settlements", ":settlementId" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" }, { "key": "settlementId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"invoiceId\": \"\",\n \"type\": \"bankFee\",\n \"invoiceSettlementDetails\": {\n \"date\": \"\",\n \"sumBaseCurrency\": \"\"\n },\n \"journalEntryRef\": {\n \"id\": \"\"\n }\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-8511788f-30b2-4dc3-8dc0-50b44d9c2e2c" }, { "id": "5f526083-946a-4ac0-af43-d3538bddc0cd", "name": "The requested resource was not found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/settlements/:settlementId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "settlements", ":settlementId" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" }, { "key": "settlementId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-5f526083-946a-4ac0-af43-d3538bddc0cd" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-8a2806bf-d7a2-4d5a-accd-0b0e6fb78c70" }, { "name": "Delete an invoice settlement", "id": "83bf9edb-d085-4044-99b0-50944c35eba8", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/settlements/:settlementId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "settlements", ":settlementId" ], "variable": [ { "id": "bfdf5a35-d889-415d-acf9-7d429df19f44", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "796b6097-2a74-4a1f-be87-6f63efabb875", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" }, { "id": "831804d5-c058-4ce3-825c-f188fb088842", "key": "settlementId", "value": "", "description": "(Required) Unique identifier of the settlement" } ] }, "description": "Delete an existing settlement.\n\n**Scope:** `invoices:write`\n" }, "response": [ { "id": "9c49dd14-fba1-4c90-afa8-0bb448e43cdb", "name": "Settlement deleted successfully", "originalRequest": { "method": "DELETE", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/settlements/:settlementId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "settlements", ":settlementId" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" }, { "key": "settlementId" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-9c49dd14-fba1-4c90-afa8-0bb448e43cdb" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-83bf9edb-d085-4044-99b0-50944c35eba8" } ], "id": "c0062d01-db50-477c-820c-274a7b1d5972", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-c0062d01-db50-477c-820c-274a7b1d5972" }, { "name": "Create an invoice settlement", "id": "117249b1-7c3f-4477-87c7-0502de36c856", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"paymentServiceFee\",\n \"invoiceSettlementDetails\": {\n \"date\": \"\",\n \"sumBaseCurrency\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/settlements", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "settlements" ], "variable": [ { "id": "1a6b0320-00dc-4dea-94c4-69856b614c3d", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "7c013791-fa82-4395-898c-1875eb1caf27", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" } ] }, "description": "Create a settlement for the invoice 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.\n\n> \ud83d\udcd8 Settlement types that can be created in Bokio API\n> - `currency`\n> - `bankFee`\n> - `paymentServiceFee`\n\n**Scope:** `invoices:write`\n" }, "response": [ { "id": "0fc4823a-5766-4ab9-8fda-52d926b475a8", "name": "Settlement created successfully", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"paymentServiceFee\",\n \"invoiceSettlementDetails\": {\n \"date\": \"\",\n \"sumBaseCurrency\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/settlements", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "settlements" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"invoiceId\": \"\",\n \"type\": \"bankFee\",\n \"invoiceSettlementDetails\": {\n \"date\": \"\",\n \"sumBaseCurrency\": \"\"\n },\n \"journalEntryRef\": {\n \"id\": \"\"\n }\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-0fc4823a-5766-4ab9-8fda-52d926b475a8" }, { "id": "096f11ad-4bbb-4ff0-86fe-1acffb5dd673", "name": "Bad request", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"paymentServiceFee\",\n \"invoiceSettlementDetails\": {\n \"date\": \"\",\n \"sumBaseCurrency\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/settlements", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "settlements" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-096f11ad-4bbb-4ff0-86fe-1acffb5dd673" }, { "id": "b7f4591e-00ad-4701-be13-0ffda81108ac", "name": "Invoice not found", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"paymentServiceFee\",\n \"invoiceSettlementDetails\": {\n \"date\": \"\",\n \"sumBaseCurrency\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/settlements", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "settlements" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-b7f4591e-00ad-4701-be13-0ffda81108ac" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-117249b1-7c3f-4477-87c7-0502de36c856" }, { "name": "Get invoice settlements", "id": "992079b3-221c-406d-a485-8531ffb4b288", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/settlements?page=1&pageSize=25&query=", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "settlements" ], "query": [ { "description": "Page number", "key": "page", "value": "1" }, { "description": "Number of items per page", "key": "pageSize", "value": "25" }, { "description": "Optional query to filter the data set with supported fields listed below and [available operations](filtering).\n\n| Field | Type |\n| ------------------------- | ----------- |\n| date | date |\n| sumBaseCurrency | decimal |\n", "key": "query", "value": "" } ], "variable": [ { "id": "7c2fc602-9ec1-4e16-8dd3-5648db58e785", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "ce789b01-b4d2-47e6-b727-2d695f7a9424", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" } ] }, "description": "Get all settlements for the invoice. Use the query parameters to filter and navigate through the results.\n\n**Scope:** `invoices:read`\n" }, "response": [ { "id": "e89ce22b-fd13-4da2-9130-8741832b9996", "name": "List of settlements", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/settlements?page=1&pageSize=25&query=", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "settlements" ], "query": [ { "description": "Page number", "key": "page", "value": "1" }, { "description": "Number of items per page", "key": "pageSize", "value": "25" }, { "description": "Optional query to filter the data set with supported fields listed below and [available operations](filtering).\n\n| Field | Type |\n| ------------------------- | ----------- |\n| date | date |\n| sumBaseCurrency | decimal |\n", "key": "query", "value": "" } ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"totalItems\": \"\",\n \"totalPages\": \"\",\n \"currentPage\": \"\",\n \"items\": [\n {\n \"id\": \"\",\n \"invoiceId\": \"\",\n \"type\": \"paymentServiceFee\",\n \"invoiceSettlementDetails\": {\n \"date\": \"\",\n \"sumBaseCurrency\": \"\"\n },\n \"journalEntryRef\": {\n \"id\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"invoiceId\": \"\",\n \"type\": \"currency\",\n \"invoiceSettlementDetails\": {\n \"date\": \"\",\n \"sumBaseCurrency\": \"\"\n },\n \"journalEntryRef\": {\n \"id\": \"\"\n }\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-e89ce22b-fd13-4da2-9130-8741832b9996" }, { "id": "162789fe-a718-4489-bab9-cb9f61572314", "name": "The requested resource was not found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId/settlements?page=1&pageSize=25&query=", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId", "settlements" ], "query": [ { "description": "Page number", "key": "page", "value": "1" }, { "description": "Number of items per page", "key": "pageSize", "value": "25" }, { "description": "Optional query to filter the data set with supported fields listed below and [available operations](filtering).\n\n| Field | Type |\n| ------------------------- | ----------- |\n| date | date |\n| sumBaseCurrency | decimal |\n", "key": "query", "value": "" } ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-162789fe-a718-4489-bab9-cb9f61572314" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-992079b3-221c-406d-a485-8531ffb4b288" } ], "id": "28a1e31b-cd0b-487a-b2d2-4ab4f012485d", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-28a1e31b-cd0b-487a-b2d2-4ab4f012485d" }, { "name": "Get an invoice", "id": "c89c19f8-f7df-4a87-a408-ee085a3a4478", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId" ], "variable": [ { "id": "68aff671-72de-4219-b61e-b0ea8c5cebfc", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "07bef412-5b6d-4898-87c6-b8a151bf4e9d", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" } ] }, "description": "Retrieve the information of the invoice with the matching invoiceId.\n\n**Tax reduction:** Personal numbers in `taxReduction.deductionPeople` have the last 4 digits masked when the invoice was created by a different integration. Masked values are returned as `YYYYMMDD-XXXX`.\n\n**Scope:** `invoices:read`\n" }, "response": [ { "id": "f7310d48-57ab-48f1-8ecf-83874598acf8", "name": "Invoice found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"invoiceDate\": \"\",\n \"lineItems\": [\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rutGardening\"\n }\n },\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rotPlumbing\"\n }\n }\n ],\n \"id\": \"\",\n \"type\": \"invoice\",\n \"customerRef\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"contactDetailRef\": {\n \"id\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n },\n \"invoiceNumber\": \"\",\n \"paymentReference\": \"\",\n \"orderNumberReference\": \"\",\n \"projectReference\": \"\",\n \"buyerReference\": \"\",\n \"contractReference\": \"\",\n \"currency\": \"SEK\",\n \"currencyRate\": 1,\n \"totalAmount\": \"\",\n \"totalTax\": \"\",\n \"paidAmount\": \"\",\n \"status\": \"draft\",\n \"dueDate\": \"\",\n \"publishedDateTime\": \"\",\n \"billingAddress\": {\n \"line1\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\",\n \"line2\": \"\",\n \"countrySubdivision\": \"\"\n },\n \"deliveryAddress\": {\n \"line1\": \"\",\n \"line2\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\"\n },\n \"taxReduction\": {\n \"type\": \"rut\",\n \"description\": \"\",\n \"deductionPeople\": [\n {\n \"personalNumber\": \"47447918-1313\",\n \"deductionAmount\": \"\"\n }\n ],\n \"propertyType\": \"housingDesignation\",\n \"realEstateNumber\": \"\",\n \"tenantOrgNumber\": \"\",\n \"apartmentNumber\": \"\",\n \"deductionAmount\": \"\",\n \"status\": \"readyToSubmit\"\n },\n \"attachmentRefs\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"journalEntryRef\": {\n \"id\": \"\"\n },\n \"creditNoteRefs\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"metadata\": {\n \"exercitation3\": \"\",\n \"anim91\": \"\",\n \"incididunt_6\": \"\",\n \"qui06\": \"\"\n }\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-f7310d48-57ab-48f1-8ecf-83874598acf8" }, { "id": "2a99326b-4506-41b0-85fc-5eaaa6261d2c", "name": "Invoice not found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-2a99326b-4506-41b0-85fc-5eaaa6261d2c" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-c89c19f8-f7df-4a87-a408-ee085a3a4478" }, { "name": "Update an invoice", "id": "8fc28139-152a-4ff6-aa2c-72399596c1be", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"invoiceDate\": \"\",\n \"lineItems\": [\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rutGardening\"\n }\n },\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rotPlumbing\"\n }\n }\n ],\n \"id\": \"\",\n \"type\": \"invoice\",\n \"customerRef\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"contactDetailRef\": {\n \"id\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n },\n \"invoiceNumber\": \"\",\n \"paymentReference\": \"\",\n \"orderNumberReference\": \"\",\n \"projectReference\": \"\",\n \"buyerReference\": \"\",\n \"contractReference\": \"\",\n \"currency\": \"SEK\",\n \"currencyRate\": 1,\n \"totalAmount\": \"\",\n \"totalTax\": \"\",\n \"paidAmount\": \"\",\n \"status\": \"draft\",\n \"dueDate\": \"\",\n \"publishedDateTime\": \"\",\n \"billingAddress\": {\n \"line1\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\",\n \"line2\": \"\",\n \"countrySubdivision\": \"\"\n },\n \"deliveryAddress\": {\n \"line1\": \"\",\n \"line2\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\"\n },\n \"taxReduction\": {\n \"type\": \"rut\",\n \"description\": \"\",\n \"deductionPeople\": [\n {\n \"personalNumber\": \"47447918-1313\",\n \"deductionAmount\": \"\"\n }\n ],\n \"propertyType\": \"housingDesignation\",\n \"realEstateNumber\": \"\",\n \"tenantOrgNumber\": \"\",\n \"apartmentNumber\": \"\",\n \"deductionAmount\": \"\",\n \"status\": \"readyToSubmit\"\n },\n \"attachmentRefs\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"journalEntryRef\": {\n \"id\": \"\"\n },\n \"creditNoteRefs\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"metadata\": {\n \"exercitation3\": \"\",\n \"anim91\": \"\",\n \"incididunt_6\": \"\",\n \"qui06\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId" ], "variable": [ { "id": "a117e5b3-fc9d-4010-b126-3c991bfb4078", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "cfd0e4ce-73dc-4c13-8802-c2d21956f05a", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" } ] }, "description": "Update an existing invoice draft for the company.\n\nThis operation will update all fields of the invoice. It's recommended that you perform a GET request\nto the invoice first to get the current state of the invoice and then update the fields you want to change.\n\n**NOTE:** It's only possible to update invoices that are in draft status.\n\n**Tax reduction:** Only the integration that created the invoice can modify tax reduction data. If a different integration includes `taxReduction` changes in the request, the changes will be silently ignored and the existing tax reduction data will be preserved.\n\n**Scope:** `invoices:write`\n" }, "response": [ { "id": "21463e8c-3672-4780-8d32-3f503439ab19", "name": "Invoice updated", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"invoiceDate\": \"\",\n \"lineItems\": [\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rutGardening\"\n }\n },\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rotPlumbing\"\n }\n }\n ],\n \"id\": \"\",\n \"type\": \"invoice\",\n \"customerRef\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"contactDetailRef\": {\n \"id\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n },\n \"invoiceNumber\": \"\",\n \"paymentReference\": \"\",\n \"orderNumberReference\": \"\",\n \"projectReference\": \"\",\n \"buyerReference\": \"\",\n \"contractReference\": \"\",\n \"currency\": \"SEK\",\n \"currencyRate\": 1,\n \"totalAmount\": \"\",\n \"totalTax\": \"\",\n \"paidAmount\": \"\",\n \"status\": \"draft\",\n \"dueDate\": \"\",\n \"publishedDateTime\": \"\",\n \"billingAddress\": {\n \"line1\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\",\n \"line2\": \"\",\n \"countrySubdivision\": \"\"\n },\n \"deliveryAddress\": {\n \"line1\": \"\",\n \"line2\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\"\n },\n \"taxReduction\": {\n \"type\": \"rut\",\n \"description\": \"\",\n \"deductionPeople\": [\n {\n \"personalNumber\": \"47447918-1313\",\n \"deductionAmount\": \"\"\n }\n ],\n \"propertyType\": \"housingDesignation\",\n \"realEstateNumber\": \"\",\n \"tenantOrgNumber\": \"\",\n \"apartmentNumber\": \"\",\n \"deductionAmount\": \"\",\n \"status\": \"readyToSubmit\"\n },\n \"attachmentRefs\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"journalEntryRef\": {\n \"id\": \"\"\n },\n \"creditNoteRefs\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"metadata\": {\n \"exercitation3\": \"\",\n \"anim91\": \"\",\n \"incididunt_6\": \"\",\n \"qui06\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"invoiceDate\": \"\",\n \"lineItems\": [\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rutGardening\"\n }\n },\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rotPlumbing\"\n }\n }\n ],\n \"id\": \"\",\n \"type\": \"invoice\",\n \"customerRef\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"contactDetailRef\": {\n \"id\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n },\n \"invoiceNumber\": \"\",\n \"paymentReference\": \"\",\n \"orderNumberReference\": \"\",\n \"projectReference\": \"\",\n \"buyerReference\": \"\",\n \"contractReference\": \"\",\n \"currency\": \"SEK\",\n \"currencyRate\": 1,\n \"totalAmount\": \"\",\n \"totalTax\": \"\",\n \"paidAmount\": \"\",\n \"status\": \"draft\",\n \"dueDate\": \"\",\n \"publishedDateTime\": \"\",\n \"billingAddress\": {\n \"line1\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\",\n \"line2\": \"\",\n \"countrySubdivision\": \"\"\n },\n \"deliveryAddress\": {\n \"line1\": \"\",\n \"line2\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\"\n },\n \"taxReduction\": {\n \"type\": \"rut\",\n \"description\": \"\",\n \"deductionPeople\": [\n {\n \"personalNumber\": \"47447918-1313\",\n \"deductionAmount\": \"\"\n }\n ],\n \"propertyType\": \"housingDesignation\",\n \"realEstateNumber\": \"\",\n \"tenantOrgNumber\": \"\",\n \"apartmentNumber\": \"\",\n \"deductionAmount\": \"\",\n \"status\": \"readyToSubmit\"\n },\n \"attachmentRefs\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"journalEntryRef\": {\n \"id\": \"\"\n },\n \"creditNoteRefs\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"metadata\": {\n \"exercitation3\": \"\",\n \"anim91\": \"\",\n \"incididunt_6\": \"\",\n \"qui06\": \"\"\n }\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-21463e8c-3672-4780-8d32-3f503439ab19" }, { "id": "36cd4e79-df9f-4f5a-bb97-f0641a0c6f87", "name": "Missing required information", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"invoiceDate\": \"\",\n \"lineItems\": [\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rutGardening\"\n }\n },\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rotPlumbing\"\n }\n }\n ],\n \"id\": \"\",\n \"type\": \"invoice\",\n \"customerRef\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"contactDetailRef\": {\n \"id\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n },\n \"invoiceNumber\": \"\",\n \"paymentReference\": \"\",\n \"orderNumberReference\": \"\",\n \"projectReference\": \"\",\n \"buyerReference\": \"\",\n \"contractReference\": \"\",\n \"currency\": \"SEK\",\n \"currencyRate\": 1,\n \"totalAmount\": \"\",\n \"totalTax\": \"\",\n \"paidAmount\": \"\",\n \"status\": \"draft\",\n \"dueDate\": \"\",\n \"publishedDateTime\": \"\",\n \"billingAddress\": {\n \"line1\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\",\n \"line2\": \"\",\n \"countrySubdivision\": \"\"\n },\n \"deliveryAddress\": {\n \"line1\": \"\",\n \"line2\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\"\n },\n \"taxReduction\": {\n \"type\": \"rut\",\n \"description\": \"\",\n \"deductionPeople\": [\n {\n \"personalNumber\": \"47447918-1313\",\n \"deductionAmount\": \"\"\n }\n ],\n \"propertyType\": \"housingDesignation\",\n \"realEstateNumber\": \"\",\n \"tenantOrgNumber\": \"\",\n \"apartmentNumber\": \"\",\n \"deductionAmount\": \"\",\n \"status\": \"readyToSubmit\"\n },\n \"attachmentRefs\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"journalEntryRef\": {\n \"id\": \"\"\n },\n \"creditNoteRefs\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"metadata\": {\n \"exercitation3\": \"\",\n \"anim91\": \"\",\n \"incididunt_6\": \"\",\n \"qui06\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-36cd4e79-df9f-4f5a-bb97-f0641a0c6f87" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-8fc28139-152a-4ff6-aa2c-72399596c1be" }, { "name": "Delete an invoice", "id": "3fad66bf-2c51-44fb-b747-deef942a7347", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId" ], "variable": [ { "id": "7dbdf034-4d58-4271-ab7d-b2e47243ffba", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" }, { "id": "494211d0-af48-4144-9e21-1d091ecf41a9", "key": "invoiceId", "value": "", "description": "(Required) Unique identifier of the invoice" } ] }, "description": "Deletes the specified invoice. Only invoices in draft status can be deleted.\n\n**Scope:** `invoices:write`\n" }, "response": [ { "id": "6c9d3e97-ff31-4d78-b633-581f7f0e785a", "name": "Invoice deleted successfully", "originalRequest": { "method": "DELETE", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-6c9d3e97-ff31-4d78-b633-581f7f0e785a" }, { "id": "4083b055-4886-4be0-a7de-139ea971effa", "name": "Invalid request or invoice cannot be deleted", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices/:invoiceId", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices", ":invoiceId" ], "variable": [ { "key": "companyId" }, { "key": "invoiceId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-4083b055-4886-4be0-a7de-139ea971effa" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-3fad66bf-2c51-44fb-b747-deef942a7347" } ], "id": "77d789cc-ec08-446b-97a5-c8fe55d70fc7", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-77d789cc-ec08-446b-97a5-c8fe55d70fc7" }, { "name": "Create an invoice", "id": "855a1565-7da6-4f97-a8ea-2c856035eeeb", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"invoiceDate\": \"\",\n \"lineItems\": [\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rutGardening\"\n }\n },\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rotPlumbing\"\n }\n }\n ],\n \"id\": \"\",\n \"type\": \"invoice\",\n \"customerRef\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"contactDetailRef\": {\n \"id\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n },\n \"invoiceNumber\": \"\",\n \"paymentReference\": \"\",\n \"orderNumberReference\": \"\",\n \"projectReference\": \"\",\n \"buyerReference\": \"\",\n \"contractReference\": \"\",\n \"currency\": \"SEK\",\n \"currencyRate\": 1,\n \"totalAmount\": \"\",\n \"totalTax\": \"\",\n \"paidAmount\": \"\",\n \"status\": \"draft\",\n \"dueDate\": \"\",\n \"publishedDateTime\": \"\",\n \"billingAddress\": {\n \"line1\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\",\n \"line2\": \"\",\n \"countrySubdivision\": \"\"\n },\n \"deliveryAddress\": {\n \"line1\": \"\",\n \"line2\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\"\n },\n \"taxReduction\": {\n \"type\": \"rut\",\n \"description\": \"\",\n \"deductionPeople\": [\n {\n \"personalNumber\": \"47447918-1313\",\n \"deductionAmount\": \"\"\n }\n ],\n \"propertyType\": \"housingDesignation\",\n \"realEstateNumber\": \"\",\n \"tenantOrgNumber\": \"\",\n \"apartmentNumber\": \"\",\n \"deductionAmount\": \"\",\n \"status\": \"readyToSubmit\"\n },\n \"attachmentRefs\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"journalEntryRef\": {\n \"id\": \"\"\n },\n \"creditNoteRefs\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"metadata\": {\n \"exercitation3\": \"\",\n \"anim91\": \"\",\n \"incididunt_6\": \"\",\n \"qui06\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices" ], "variable": [ { "id": "b2c1d8fd-5fcc-4a8a-b5da-aad4461fd856", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" } ] }, "description": "Creates a new draft invoice for the company.\n\n**Scope:** `invoices:write`\n" }, "response": [ { "id": "90e992bc-bdf8-4815-886c-0b4d8d655f85", "name": "Invoice created", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"invoiceDate\": \"\",\n \"lineItems\": [\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rutGardening\"\n }\n },\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rotPlumbing\"\n }\n }\n ],\n \"id\": \"\",\n \"type\": \"invoice\",\n \"customerRef\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"contactDetailRef\": {\n \"id\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n },\n \"invoiceNumber\": \"\",\n \"paymentReference\": \"\",\n \"orderNumberReference\": \"\",\n \"projectReference\": \"\",\n \"buyerReference\": \"\",\n \"contractReference\": \"\",\n \"currency\": \"SEK\",\n \"currencyRate\": 1,\n \"totalAmount\": \"\",\n \"totalTax\": \"\",\n \"paidAmount\": \"\",\n \"status\": \"draft\",\n \"dueDate\": \"\",\n \"publishedDateTime\": \"\",\n \"billingAddress\": {\n \"line1\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\",\n \"line2\": \"\",\n \"countrySubdivision\": \"\"\n },\n \"deliveryAddress\": {\n \"line1\": \"\",\n \"line2\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\"\n },\n \"taxReduction\": {\n \"type\": \"rut\",\n \"description\": \"\",\n \"deductionPeople\": [\n {\n \"personalNumber\": \"47447918-1313\",\n \"deductionAmount\": \"\"\n }\n ],\n \"propertyType\": \"housingDesignation\",\n \"realEstateNumber\": \"\",\n \"tenantOrgNumber\": \"\",\n \"apartmentNumber\": \"\",\n \"deductionAmount\": \"\",\n \"status\": \"readyToSubmit\"\n },\n \"attachmentRefs\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"journalEntryRef\": {\n \"id\": \"\"\n },\n \"creditNoteRefs\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"metadata\": {\n \"exercitation3\": \"\",\n \"anim91\": \"\",\n \"incididunt_6\": \"\",\n \"qui06\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices" ], "variable": [ { "key": "companyId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"invoiceDate\": \"\",\n \"lineItems\": [\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rutGardening\"\n }\n },\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rotPlumbing\"\n }\n }\n ],\n \"id\": \"\",\n \"type\": \"invoice\",\n \"customerRef\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"contactDetailRef\": {\n \"id\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n },\n \"invoiceNumber\": \"\",\n \"paymentReference\": \"\",\n \"orderNumberReference\": \"\",\n \"projectReference\": \"\",\n \"buyerReference\": \"\",\n \"contractReference\": \"\",\n \"currency\": \"SEK\",\n \"currencyRate\": 1,\n \"totalAmount\": \"\",\n \"totalTax\": \"\",\n \"paidAmount\": \"\",\n \"status\": \"draft\",\n \"dueDate\": \"\",\n \"publishedDateTime\": \"\",\n \"billingAddress\": {\n \"line1\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\",\n \"line2\": \"\",\n \"countrySubdivision\": \"\"\n },\n \"deliveryAddress\": {\n \"line1\": \"\",\n \"line2\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\"\n },\n \"taxReduction\": {\n \"type\": \"rut\",\n \"description\": \"\",\n \"deductionPeople\": [\n {\n \"personalNumber\": \"47447918-1313\",\n \"deductionAmount\": \"\"\n }\n ],\n \"propertyType\": \"housingDesignation\",\n \"realEstateNumber\": \"\",\n \"tenantOrgNumber\": \"\",\n \"apartmentNumber\": \"\",\n \"deductionAmount\": \"\",\n \"status\": \"readyToSubmit\"\n },\n \"attachmentRefs\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"journalEntryRef\": {\n \"id\": \"\"\n },\n \"creditNoteRefs\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"metadata\": {\n \"exercitation3\": \"\",\n \"anim91\": \"\",\n \"incididunt_6\": \"\",\n \"qui06\": \"\"\n }\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-90e992bc-bdf8-4815-886c-0b4d8d655f85" }, { "id": "e4f072af-f903-42d7-9e8b-dd1c2e6c99fa", "name": "Missing required information", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"invoiceDate\": \"\",\n \"lineItems\": [\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rutGardening\"\n }\n },\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rotPlumbing\"\n }\n }\n ],\n \"id\": \"\",\n \"type\": \"invoice\",\n \"customerRef\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"contactDetailRef\": {\n \"id\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n },\n \"invoiceNumber\": \"\",\n \"paymentReference\": \"\",\n \"orderNumberReference\": \"\",\n \"projectReference\": \"\",\n \"buyerReference\": \"\",\n \"contractReference\": \"\",\n \"currency\": \"SEK\",\n \"currencyRate\": 1,\n \"totalAmount\": \"\",\n \"totalTax\": \"\",\n \"paidAmount\": \"\",\n \"status\": \"draft\",\n \"dueDate\": \"\",\n \"publishedDateTime\": \"\",\n \"billingAddress\": {\n \"line1\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\",\n \"line2\": \"\",\n \"countrySubdivision\": \"\"\n },\n \"deliveryAddress\": {\n \"line1\": \"\",\n \"line2\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\"\n },\n \"taxReduction\": {\n \"type\": \"rut\",\n \"description\": \"\",\n \"deductionPeople\": [\n {\n \"personalNumber\": \"47447918-1313\",\n \"deductionAmount\": \"\"\n }\n ],\n \"propertyType\": \"housingDesignation\",\n \"realEstateNumber\": \"\",\n \"tenantOrgNumber\": \"\",\n \"apartmentNumber\": \"\",\n \"deductionAmount\": \"\",\n \"status\": \"readyToSubmit\"\n },\n \"attachmentRefs\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"journalEntryRef\": {\n \"id\": \"\"\n },\n \"creditNoteRefs\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"metadata\": {\n \"exercitation3\": \"\",\n \"anim91\": \"\",\n \"incididunt_6\": \"\",\n \"qui06\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices" ], "variable": [ { "key": "companyId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\",\n \"bokioErrorId\": \"\",\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-e4f072af-f903-42d7-9e8b-dd1c2e6c99fa" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-855a1565-7da6-4f97-a8ea-2c856035eeeb" }, { "name": "Get invoices", "id": "967870f0-2413-433f-9949-7f82f625bd3a", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices?page=1&pageSize=25&query=", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices" ], "query": [ { "description": "Page number", "key": "page", "value": "1" }, { "description": "Number of items per page", "key": "pageSize", "value": "25" }, { "description": "Optional query to filter the data set with supported fields listed below and [available operations](filtering).\nView documentation for filtering on metadata [here](metadata).\n\n| Field | Type |\n| -------------------- | ----------- |\n| type | string |\n| customerRef | string |\n| orderNumberReference | string |\n| projectReference | string |\n| buyerReference | string |\n| contractReference | string |\n| currency | string |\n| totalAmount | number |\n| status | string |\n| invoiceDate | date |\n| dueDate | date |\n| metadata | string |\n", "key": "query", "value": "" } ], "variable": [ { "id": "c1cf6aea-93bd-47cd-b8b8-d76fd3406599", "key": "companyId", "value": "", "description": "(Required) Unique identifier of the company" } ] }, "description": "Get all invoices for the company. Use the query parameters to filter and navigate through the results.\n\n**Tax reduction:** Personal numbers in `taxReduction.deductionPeople` have the last 4 digits masked when the invoice was created by a different integration. Masked values are returned as `YYYYMMDD-XXXX`.\n\n**Scope:** `invoices:read`\n" }, "response": [ { "id": "86383a6b-5342-4c0e-85fe-ab8779fb41fd", "name": "Invoices found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/companies/:companyId/invoices?page=1&pageSize=25&query=", "host": [ "{{baseUrl}}" ], "path": [ "companies", ":companyId", "invoices" ], "query": [ { "description": "Page number", "key": "page", "value": "1" }, { "description": "Number of items per page", "key": "pageSize", "value": "25" }, { "description": "Optional query to filter the data set with supported fields listed below and [available operations](filtering).\nView documentation for filtering on metadata [here](metadata).\n\n| Field | Type |\n| -------------------- | ----------- |\n| type | string |\n| customerRef | string |\n| orderNumberReference | string |\n| projectReference | string |\n| buyerReference | string |\n| contractReference | string |\n| currency | string |\n| totalAmount | number |\n| status | string |\n| invoiceDate | date |\n| dueDate | date |\n| metadata | string |\n", "key": "query", "value": "" } ], "variable": [ { "key": "companyId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"totalItems\": \"\",\n \"totalPages\": \"\",\n \"currentPage\": \"\",\n \"items\": [\n {\n \"invoiceDate\": \"\",\n \"lineItems\": [\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rut\",\n \"jobType\": \"rutGardening\"\n }\n },\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"services\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rut\",\n \"jobType\": \"rutPersonalHelpCare\"\n }\n }\n ],\n \"id\": \"\",\n \"type\": \"invoice\",\n \"customerRef\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"contactDetailRef\": {\n \"id\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n },\n \"invoiceNumber\": \"\",\n \"paymentReference\": \"\",\n \"orderNumberReference\": \"\",\n \"projectReference\": \"\",\n \"buyerReference\": \"\",\n \"contractReference\": \"\",\n \"currency\": \"SEK\",\n \"currencyRate\": 1,\n \"totalAmount\": \"\",\n \"totalTax\": \"\",\n \"paidAmount\": \"\",\n \"status\": \"draft\",\n \"dueDate\": \"\",\n \"publishedDateTime\": \"\",\n \"billingAddress\": {\n \"line1\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\",\n \"line2\": \"\",\n \"countrySubdivision\": \"\"\n },\n \"deliveryAddress\": {\n \"line1\": \"\",\n \"line2\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\"\n },\n \"taxReduction\": {\n \"type\": \"rut\",\n \"description\": \"\",\n \"deductionPeople\": [\n {\n \"personalNumber\": \"24433313-4466\",\n \"deductionAmount\": \"\"\n }\n ],\n \"propertyType\": \"housingDesignation\",\n \"realEstateNumber\": \"\",\n \"tenantOrgNumber\": \"\",\n \"apartmentNumber\": \"\",\n \"deductionAmount\": \"\",\n \"status\": \"awaitingPayment\"\n },\n \"attachmentRefs\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"journalEntryRef\": {\n \"id\": \"\"\n },\n \"creditNoteRefs\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"metadata\": {\n \"magna_82\": \"\",\n \"essec1\": \"\",\n \"laborume\": \"\",\n \"sint_38\": \"\"\n }\n },\n {\n \"invoiceDate\": \"\",\n \"lineItems\": [\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rutPersonalHelpCare\"\n }\n },\n {\n \"description\": \"\",\n \"itemType\": \"salesItem\",\n \"productType\": \"goods\",\n \"quantity\": 1,\n \"unitPrice\": \"\",\n \"taxRate\": \"\",\n \"id\": \"\",\n \"itemRef\": {\n \"id\": \"\",\n \"description\": \"\"\n },\n \"unitType\": \"unspecified\",\n \"bookkeepingAccountNumber\": \"\",\n \"taxReduction\": {\n \"taxReductionType\": \"rot\",\n \"jobType\": \"rutPersonalHelpCare\"\n }\n }\n ],\n \"id\": \"\",\n \"type\": \"invoice\",\n \"customerRef\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"contactDetailRef\": {\n \"id\": \"\",\n \"email\": \"\",\n \"phone\": \"\"\n },\n \"invoiceNumber\": \"\",\n \"paymentReference\": \"\",\n \"orderNumberReference\": \"\",\n \"projectReference\": \"\",\n \"buyerReference\": \"\",\n \"contractReference\": \"\",\n \"currency\": \"SEK\",\n \"currencyRate\": 1,\n \"totalAmount\": \"\",\n \"totalTax\": \"\",\n \"paidAmount\": \"\",\n \"status\": \"draft\",\n \"dueDate\": \"\",\n \"publishedDateTime\": \"\",\n \"billingAddress\": {\n \"line1\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\",\n \"line2\": \"\",\n \"countrySubdivision\": \"\"\n },\n \"deliveryAddress\": {\n \"line1\": \"\",\n \"line2\": \"\",\n \"city\": \"\",\n \"postalCode\": \"\",\n \"country\": \"\"\n },\n \"taxReduction\": {\n \"type\": \"rut\",\n \"description\": \"\",\n \"deductionPeople\": [\n {\n \"personalNumber\": \"72651137-2866\",\n \"deductionAmount\": \"\"\n }\n ],\n \"propertyType\": \"realEstate\",\n \"realEstateNumber\": \"\",\n \"tenantOrgNumber\": \"\",\n \"apartmentNumber\": \"\",\n \"deductionAmount\": \"\",\n \"status\": \"draft\"\n },\n \"attachmentRefs\": [\n {\n \"id\": \"\",\n \"name\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\"\n }\n ],\n \"journalEntryRef\": {\n \"id\": \"\"\n },\n \"creditNoteRefs\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"metadata\": {\n \"reprehenderit18\": \"\",\n \"minim7b\": \"\",\n \"voluptate_26a\": \"\",\n \"dolor7a2\": \"\"\n }\n }\n ]\n}", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-86383a6b-5342-4c0e-85fe-ab8779fb41fd" } ], "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-967870f0-2413-433f-9949-7f82f625bd3a" } ], "id": "e6178909-484c-4ad2-b79a-ccad1b7692d3", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-e6178909-484c-4ad2-b79a-ccad1b7692d3" } ], "id": "6edf94a1-0163-4c89-ae9e-575f3b1e648c", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-6edf94a1-0163-4c89-ae9e-575f3b1e648c" } ], "id": "c34626b1-20d3-44ec-8620-d6701fca935e", "createdAt": "2026-07-28T01:15:38.000Z", "updatedAt": "2026-07-28T01:15:38.000Z", "uid": "35240-c34626b1-20d3-44ec-8620-d6701fca935e" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.bokio.se/v1" } ] }