What you can build today
The WonderFatoora API (v1) lets a company on the Business or Enterprise plan create tax invoices from its own systems (an online store, a booking system, a point of sale or a subscription platform) and read them back with their ZATCA status. Issuing, legal numbering, the QR code and, for companies linked to ZATCA, clearance or reporting all happen inside WonderFatoora, exactly as for invoices made in the dashboard.
GET
/api/v1/ping
Available
Check that a key works and see the company it acts for.
POST
/api/v1/invoices
Available
Create a draft or issue a tax invoice, with an existing or inline customer, foreign currency and VAT exemption reasons.
GET
/api/v1/invoices/{id}
Available
Read an invoice with its items, totals and ZATCA status.
POST
/api/v1/invoices/{id}/issue
Available
Validate and issue a draft created earlier, and download its PDF or XML.
POST
/api/v1/customers
Available
Create, list and update customers, with the full national address.
POST
/api/v1/invoices/{id}/notes
Available
Create and issue credit and debit notes.
POST
/api/v1/webhook-endpoints
Available
Receive signed webhooks when invoices are issued, cleared, rejected or paid.
Each key acts for one company. The company is fixed by the key; no request can choose or change it.
Start here
Quick start
From an API key to your first draft invoice in five minutes.
Authentication
Sending the key, scopes, expiry and rotation.
API reference
Every endpoint, field and response.
Errors & troubleshooting
Every error code and how to fix it.
Guides
Invoices
Drafts and issued invoices, currencies, discounts, exemptions and ZATCA status.
Customers
Attaching buyers, and what ZATCA needs for business buyers.
Multi-tenant SaaS
Invoicing for your own company or for your customers' companies.
Security
How keys and data are protected, and what we ask of you.
Platform features
Build and test end to end: a sandbox company to try everything safely, webhooks instead of polling, OAuth app connections for SaaS products, and an MCP server for AI agents.
Webhooks
Signed notifications when invoices are issued, cleared or paid.
Sandbox
A test company with test keys and simulated ZATCA results.
AI agents & MCP
A remote MCP server with human approval for issuing.
SDKs
Official PHP, Node.js and Python libraries, built and awaiting publication.
Use cases
Saudi e-invoicing API
Issue compliant tax invoices from any system.
ZATCA Phase 2 API integration
Clearance and reporting from your own software.
SaaS billing API
A tax invoice for every subscription payment.
Laravel integration
A service class, a queued job and error handling.
Multi-tenant invoice API
Invoicing for many seller companies from one platform.
AI agent integration
Agents prepare drafts; people issue.
MCP server
Wonder Fatoora MCP: tools for AI agents.
Ready to build?
API access is part of the Business and Enterprise plans. Create a key in Settings → API keys and make your first call in minutes.