Runtime and readiness

get/v1/runtime

Scope tenant:read

The first call after the token. Returns the manufacturer, the ESIR number (empty until the Tax Administration assigns one), the version, the organization and client id from the token, and whether the fiscal adapter is configured. Use it to verify credentials and in health checks.

Example

GET /v1/runtime

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

Responses

getRuntime: Responses
200 OK	Runtime context`RuntimeInfo`

200 OK

{
  "manufacturer": "BOKA GROUP DOO",
  "productName": "BokaPOS",
  "esirNumber": "",
  "softwareVersion": "1.0.0",
  "buildCommit": "1f0d454e8b2c9a7d6f5e4c3b2a1908f7e6d5c4b3",
  "instanceId": "api-bokapos-rs",
  "organizationId": "7c1e9a4b-2d3f-4e5a-b6c7-8d9e0f1a2b3c",
  "clientId": "boka-sbx-k7m2p9x4q1wz",
  "fiscalEndpointsEnabled": true,
  "pfrAdapter": "configured"
}

Response: RuntimeInfo

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

getRuntime: Response
Field	Type	Description
`manufacturer`required	string	`BOKA GROUP DOO`Values
`productName`required	string	`BokaPOS`Values
`esirNumber`required	string	The ESIR number printed on every fiscal receipt, as the Tax Administration approval number and the declared product version separated by a slash. Empty while no approval decision has assigned one. This is not the deployed build; see softwareVersion. max 60
`softwareVersion`required	string	min 1max 64pattern ^[0-9A-Za-z][0-9A-Za-z.+-]{0,63}$
`buildCommit`required	string	Exact 40-character Git commit; only Development may report the explicit unversioned-development placeholder.
`instanceId`required	string	Deployment-owned ESIR software instance identity; never a tenant, OAuth client, certificate, or approval number. min 1max 128
`organizationId`required	uuid
`clientId`required	string
`fiscalEndpointsEnabled`required	boolean
`pfrAdapter`required	string	`configurednot-configured`Values