Read an operation

get/v1/operations/{operationId}

Scope operations:read

The same state as the fiscal document in a shorter shape, from the database and without contacting the V-PFR. Use it when a 409 returns an operationId or when checking an unknown outcome.

Contract notes (OpenAPI)

Reads Boka's durable PostgreSQL operation state without contacting V-PFR, opening a security element, recovering an outcome, or retrying a fiscal command. A false fiscalized value is never a receipt.

Parameters

getOperation: Parameters
Field	In	Type	Description
`operationId`required	path	uuid

Example

GET /v1/operations/{operationId}

curl -X GET "https://api.bokapos.rs/v1/operations/9f8e7d6c-5b4a-4321-8765-0fedcba98761" \
  -H "Authorization: Bearer $BOKAPOS_TOKEN"

Responses

getOperation: Responses
200 OK	Operation`Operation`
404 Not Found	Resource does not exist within the authenticated tenant scope`ErrorCode`

200 OK

{
  "id": "9f8e7d6c-5b4a-4321-8765-0fedcba98761",
  "kind": "FISCAL_DOCUMENT",
  "status": "FISCALIZED",
  "fiscalized": true,
  "failureCode": null,
  "retryable": false,
  "resourceUrl": "/v1/fiscal-documents/9f8e7d6c-5b4a-4321-8765-0fedcba98761",
  "createdAt": "2026-09-01T08:15:31.902Z",
  "updatedAt": "2026-09-01T08:15:32.611Z"
}

Examples

unknown

GET /v1/operations/{operationId}

curl -X GET "https://api.bokapos.rs/v1/operations/4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f70" \
  -H "Authorization: Bearer $BOKAPOS_TOKEN"

200 OK

{
  "id": "4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f70",
  "kind": "FISCAL_DOCUMENT",
  "status": "OUTCOME_UNKNOWN",
  "fiscalized": false,
  "failureCode": "PFR_RESPONSE_NOT_OBSERVED",
  "retryable": false,
  "resourceUrl": "/v1/fiscal-documents/4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f70",
  "createdAt": "2026-09-01T09:00:00.000Z",
  "updatedAt": "2026-09-01T09:00:31.000Z"
}

Response: Operation

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

getOperation: Response
Field	Type	Description
`id`required	uuid
`kind`required	const "FISCAL_DOCUMENT"
`status`required	FiscalDocumentStatus	`RECEIVEDVALIDATEDSUBMITTINGFISCALIZEDREJECTEDNOT_FISCALIZEDOUTCOME_UNKNOWNRECONCILING`Values
`fiscalized`required	boolean
`failureCode`required	string\| null (nullable)
`retryable`required	boolean
`resourceUrl`required	uri-reference
`createdAt`required	date-time
`updatedAt`required	date-time