لم تُترجم هذه الصفحة بعد
تعرض هذه الصفحة النص الإنجليزي حتى تصدر ترجمتها.
title: Developers description: Two surfaces: the Integration API, which needs an API key and a plan with API access, and the free public tools, which need nothing. There are no outbound webhooks. persona: developer verified: 2026-09-29 app_version: 2026.09
Developers¶
Two surfaces: the Integration API, which needs an API key and a plan with API access, and the free public tools, which need nothing. There are no outbound webhooks.
| Page | What it covers |
|---|---|
| Authentication and API keys | Bearer keys, what a key can and cannot do, and the 403 you get on a plan without API access |
| Quickstart | Find your device and seller, create an invoice, poll it to cleared, fetch the PDF |
| Worked example | The same steps on the wire: every request and response from one sandbox run |
| Reference data | VAT categories and rates, invoice type codes, units of measure, payment means, charge and allowance codes |
| Codes and constants | Every fixed value in an invoice body or response, and which values are accepted |
| Usage and quotas | Read your monthly invoice allowance before you hit it |
| Public tools | Free, unauthenticated endpoints: decode a ZATCA QR, validate an invoice XML, calculate VAT, parse an invoice |
| Errors and rate limits | Status codes, error bodies, the per-key and per-IP rate limits, and fair use |
| Postman collection | Import the collection and run the requests against the sandbox |
| API reference | Generated from the Integration API's OpenAPI document |
| Changelog | What changed in the API, by date |