Usage by connected account

Endpoint for retrieving how many documents each connected account submitted in a period, and whether each account is active now (has an active device), so you can bill each of your customers. Accepted documents are the ones ZATCA accepted, each charged one document credit in production; pending documents still wait for ZATCA. Documents are counted by the day they were submitted, in Riyadh time; production documents from 2026-10-21. The report covers the environment of your API key or of the environment header, and production when neither names one, so you can build your billing against simulation first. Without a period, the current contract term is reported, or the current month when there is none.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
date

The last submission date to count, inclusive, in Riyadh time. Defaults to the end of the current term or month.

date

The first submission date to count, in Riyadh time. Defaults to the start of the current term or month.

Headers
string

The ZATCA environment to use, one of ['production', 'simulation']. A ZATCA API key (starting with zatca_live_ or zatca_sim_) already names its environment, so the header is optional with it and must match it when sent. Other API keys and OAuth tokens need it.

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json