Licence state

get/v1/license

Scope tenant:read

Whether production fiscalization is currently allowed, which modules are enabled and which prices apply. Sandbox is never billed and never blocked.

Contract notes (OpenAPI)

Any customer human or API client. Reports the licence state (none, active, suspended, not-started, expired), whether production fiscalization is currently allowed, which paid modules (Advance, E-mail) are enabled, and the effective prices in RSD with VAT included. Sandbox elements and sandbox traffic are never gated by licensing. A refused production command returns 403 with LICENSE_REQUIRED, LICENSE_NOT_STARTED, LICENSE_EXPIRED, LICENSE_SUSPENDED or MODULE_NOT_LICENSED before anything is reserved or sent to the V-PFR. Refunds of already fiscalized receipts and advance cancellations are never refused by licensing.

Example

GET /v1/license

curl -X GET "https://api.bokapos.rs/v1/license" \
  -H "Authorization: Bearer $BOKAPOS_TOKEN"

Responses

getLicenseSummary: Responses
200 OK	Licence summary`LicenseSummary`

200 OK

{
  "state": "active",
  "productionFiscalizationAllowed": true,
  "modules": {
    "advance": true,
    "email": false
  },
  "startsOn": "2026-09-01",
  "endsOn": null,
  "prices": {
    "basePricePerElement": 1600,
    "includedDocuments": 600,
    "overageDocumentPrice": 1,
    "advanceModulePrice": 600,
    "emailModulePrice": 600,
    "vatRate": 0.2
  }
}

Response: LicenseSummary

Field descriptions come from the OpenAPI contract; field names and values are identical in both languages.

getLicenseSummary: Response
Field	Type	Description
`state`required	LicenseState	Customer-facing licence state on the Belgrade calendar date of the request. `noneactivesuspendednot-startedexpired`Values
`productionFiscalizationAllowed`required	boolean
`modules`required	object
`advance`required	boolean
`email`required	boolean
`startsOn`required	date\| null (nullable)
`endsOn`required	date\| null (nullable)
`prices`required	LicensePriceList	Prices in RSD with VAT included. The base price is per active production security element per month; modules are per organization per month.
`basePricePerElement`required	number
`includedDocuments`required	integer
`overageDocumentPrice`required	number
`advanceModulePrice`required	number
`emailModulePrice`required	number
`vatRate`required	number	Fraction