Get Device

Returns information about a fiscal device, including its current status and available tax types.

GET /api/device/{zimraDeviceId}

Path Parameters

Parameter	Type	Description
zimraDeviceId	int	The ZIMRA device ID

Response (200 OK)

Field	Type	Description
SerialNumber	string	Device serial number
ZimraDeviceId	int	ZIMRA device identifier
CertificateExpires	datetime?	Device certificate expiration date
GlobalReceiptCounter	int	Total number of receipts processed by this device
FiscalDayReceiptCounter	int	Number of receipts in the current fiscal day
FiscalDayNumber	int	Current fiscal day number
FiscalDayOpened	datetime?	When the current fiscal day was opened
FiscalDayClosed	datetime?	When the fiscal day was last closed
FiscalDayStatus	string?	"FiscalDayClosed", "FiscalDayOpened", "FiscalDayCloseInitiated", or "FiscalDayCloseFailed"
FiscalDayClosingErrorCode	string?	If close failed: "BadCertificateSignature", "MissingReceipts", "ReceiptsWithValidationErrors", or "CountersMismatch"
TaxPayerName	string?	Registered taxpayer name
TaxPayerTin	string?	Taxpayer TIN/BP number
TaxPayerVatNumber	string?	Taxpayer VAT number
TaxTypes	array	Available tax types for this device. See below.
SubmitReceiptsBlockedReason	string?	ZIMRA reason code if the device is blocked from submitting
SubmitReceiptsBlockedDate	datetime?	When the device was blocked

Tax Types

Field	Type	Description
Name	string	Tax type name (e.g. "VAT 15%")
Percent	decimal?	Tax percentage. null means tax-exempt.
TaxId	int	Internal tax ID (not used in receipt requests — use TaxPercent instead)
ValidFrom	datetime	When this tax type becomes effective
ValidUntil	datetime?	When this tax type expires (null = no expiry)

Error Responses

Status Code	Reason
401 Unauthorized	Authentication failed
404 Not Found	Device with the given ZIMRA device ID does not exist for this tenant