# Billecta API

**Canonical:** https://apis.io/apis/billecta/billecta-api/  
**Provider:** Billecta — https://apis.io/providers/billecta/  
**Base URL:** https://api.billecta.com  
**Documentation:** https://docs.billecta.com/api

Billecta API is one of 2 APIs that [Billecta](https://apis.io/providers/billecta/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Billecta API as documented publicly: 38 operations. Contract generated from the documentation by API Evangelist (2026-10-15); not the provider's own document.

## Operations (38)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/accounting/lockedperiod/ {id}` | Update the locked bookkeeping period |
| POST | `/v1/accounting/{accountingid}` | Request creation of accounting/bookkeeping file for a specific period |
| PUT | `/v1/accounting/{accountingid}` | Update accounting/bookkeeping settings |
| DELETE | `/v1/accounting/{accountingid}/ {id}` | Delete locked bookkeeping period |
| GET | `/v1/accounting/{accountingid}/ {id}` | Get locked bookkeeping period |
| DELETE | `/v1/accountingdimensions/dimension` | Delete a dimension |
| POST | `/v1/accountingdimensions/dimension` | Create a dimension |
| PUT | `/v1/accountingdimensions/dimension` | Update a dimension |
| GET | `/v1/accountingdimensions/dimension/ {id}` | Get a dimension |
| GET | `/v1/accountingdimensions/dimensions` | Get all dimensions |
| POST | `/v1/addons/creditoraddons` | Get list of addons |
| DELETE | `/v1/addons/{addonid}` | Delete autogiro addon |
| GET | `/v1/addons/{addonid}` | Get autogiro addon settings |
| PUT | `/v1/addons/{addonid}` | Create or update autogiro addon |
| DELETE | `/v1/authentication/apiauthenticate` | Delete current SecureToken |
| POST | `/v1/authentication/apiauthenticate` | POST /v1/authentication/apiauthenticate |
| GET | `/v1/authentication/{authenticationid}` | Authenticate – GET (or POST) /v1/authentication/apiauthenticate to obtain a SecureToken. |
| POST | `/v1/bankAccount/InitiateRetrieval` | Initiate account retrieval – POST /v1/bankAccount/InitiateRetrieval with CreditorPublicId and optional PersonalIdNumber. |
| POST | `/v1/bankaccount/initiateretrieval` | Initiating bank account numbers retrieval |
| POST | `/v1/bankid/phoneauthentication` | Create Mobile BankID Phone authentication request |
| PUT | `/v1/bankid/{bankidid}` | Create Mobile BankID authentication request |
| GET | `/v1/common/{commonid}` | Get supported countries |
| DELETE | `/v1/contractinvoice/action` | Delete a contract invoice |
| GET | `/v1/contractinvoice/{contractinvoiceid}` | Get all contract invoices |
| POST | `/v1/contractinvoice/{contractinvoiceid}` | Create contract invoice – call POST /v1/contractinvoice/action (details not listed on the page). |
| DELETE | `/v1/costcenters/costcenter` | Delete a cost center |
| PUT | `/v1/costcenters/costcenter` | Update a cost center |
| GET | `/v1/costcenters/{costcenterid}` | Get a cost center |
| POST | `/v1/costcenters/{costcenterid}` | Create a cost center |
| POST | `/v1/creditors/creditor` | Create a creditor |
| DELETE | `/v1/creditors/{creditorid}` | Delete a creditor |
| GET | `/v1/creditors/{creditorid}` | Get a creditor |
| PUT | `/v1/creditors/{creditorid}` | Update a creditor |
| POST | `/v1/debtors/debtor` | Create debtor – call POST /v1/debtors/debtor with a DebtorView body. |
| PUT | `/v1/invoice/attest/{id}` | Attest the invoice – call PUT /v1/invoice/attest/{id} with the id returned from invoice creation. |
| POST | `/v1/products/product` | Create product – call POST /v1/products/product with a ProductView body. |
| POST | `/v1/search/actions` | Rate limit for POST /v1/search/actions is 100 per minute and 30 per 10 seconds. |
| POST | `/v1/{v1id}/action` | Create invoice – call POST /v1/invoice/action with an InvoiceActionEntryView body. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/billecta/refs/heads/main/openapi/_ae-authored/billecta-openapi-generated.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/billecta/refs/heads/main/json-schema/billecta-post-v1-accounting-accountingid-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/billecta/refs/heads/main/json-schema/billecta-post-v1-bankid-phoneauthentication-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/billecta/refs/heads/main/json-schema/billecta-put-v1-bankid-bankidid-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/billecta/refs/heads/main/json-schema/billecta-put-v1-accounting-accountingid-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/billecta/refs/heads/main/json-schema/billecta-post-v1-bankaccount-initiateretrieval-request2-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/billecta/refs/heads/main/json-schema/billecta-post-v1-bankaccount-initiateretrieval-request-schema.json

## Other Billecta APIs (1)

- [Billecta API](https://apis.io/apis/billecta/billecta-api-2/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/billecta/billecta-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/billecta/.