{"openapi":"3.0.3","info":{"title":"UAE TAX AI API","description":"Public API for UAE TAX AI - Automated VAT & Corporate Tax for UAE SMBs","version":"1.0.0","contact":{"email":"developers@uaetaxpro.com","url":"https://docs.uaetaxpro.com"}},"servers":[{"url":"https://api.uaetaxpro.com","description":"Production"},{"url":"https://sandbox-api.uaetaxpro.com","description":"Sandbox"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"http","scheme":"bearer","description":"API key (utp_live_xxx or utp_sandbox_xxx)"}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"},"documentation_url":{"type":"string"}}}}},"Transaction":{"type":"object","properties":{"id":{"type":"integer"},"type":{"type":"string","enum":["sale","purchase","expense","income"]},"amount":{"type":"number"},"vat_rate":{"type":"number"},"vat_amount":{"type":"number"},"description":{"type":"string"},"category":{"type":"string"},"invoice_number":{"type":"string"},"transaction_date":{"type":"string","format":"date-time"}}},"VATReturn":{"type":"object","properties":{"id":{"type":"integer"},"period":{"type":"string"},"output_vat":{"type":"number"},"input_vat":{"type":"number"},"net_vat":{"type":"number"},"status":{"type":"string"}}}}},"paths":{"/api/v1/transactions":{"get":{"summary":"List transactions","tags":["Transactions"],"parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"page_size","in":"query","schema":{"type":"integer","default":50}},{"name":"type","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"List of transactions"},"401":{"description":"Authentication failed"},"429":{"description":"Rate limit exceeded"}}},"post":{"summary":"Create transaction","tags":["Transactions"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Transaction"}}}},"responses":{"201":{"description":"Transaction created"}}}},"/api/v1/transactions/{id}":{"get":{"summary":"Get transaction","tags":["Transactions"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Transaction details"}}},"put":{"summary":"Update transaction","tags":["Transactions"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Transaction updated"}}},"delete":{"summary":"Delete transaction","tags":["Transactions"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Transaction deleted"}}}},"/api/v1/vat/summary":{"get":{"summary":"Get VAT summary","tags":["VAT"],"parameters":[{"name":"period","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"VAT summary"}}}},"/api/v1/vat/returns":{"get":{"summary":"List VAT returns","tags":["VAT"],"responses":{"200":{"description":"List of VAT returns"}}}},"/api/v1/vat/returns/generate":{"post":{"summary":"Generate VAT return","tags":["VAT"],"responses":{"201":{"description":"VAT return generated"}}}},"/api/v1/corporate-tax/assessment/{year}":{"get":{"summary":"Get corporate tax assessment","tags":["Corporate Tax"],"parameters":[{"name":"year","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Tax assessment"}}}},"/api/v1/corporate-tax/calculate":{"post":{"summary":"Calculate corporate tax","tags":["Corporate Tax"],"responses":{"200":{"description":"Tax calculation"}}}},"/api/v1/corporate-tax/sbr-eligibility":{"get":{"summary":"Check SBR eligibility","tags":["Corporate Tax"],"responses":{"200":{"description":"SBR eligibility status"}}}},"/api/v1/corporate-tax/qfzp-status":{"get":{"summary":"Get QFZP status","tags":["Corporate Tax"],"responses":{"200":{"description":"QFZP status"}}}},"/api/v1/e-invoices":{"get":{"summary":"List e-invoices","tags":["E-Invoicing"],"responses":{"200":{"description":"List of e-invoices"}}}},"/api/v1/e-invoices/generate":{"post":{"summary":"Generate e-invoice","tags":["E-Invoicing"],"responses":{"201":{"description":"E-invoice generated"}}}},"/api/v1/e-invoices/validate":{"post":{"summary":"Validate e-invoice","tags":["E-Invoicing"],"responses":{"200":{"description":"Validation result"}}}},"/api/v1/e-invoices/submit":{"post":{"summary":"Submit e-invoice","tags":["E-Invoicing"],"responses":{"200":{"description":"E-invoice submitted"}}}},"/api/v1/faf/generate":{"post":{"summary":"Generate FAF export","tags":["FAF"],"responses":{"200":{"description":"FAF export generated"}}}},"/api/v1/faf/exports":{"get":{"summary":"List FAF exports","tags":["FAF"],"responses":{"200":{"description":"List of FAF exports"}}}},"/api/v1/reports/profit-loss":{"get":{"summary":"Profit & Loss report","tags":["Reports"],"parameters":[{"name":"year","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"P&L report"}}}},"/api/v1/reports/balance-sheet":{"get":{"summary":"Balance Sheet","tags":["Reports"],"responses":{"200":{"description":"Balance sheet"}}}},"/api/v1/reports/tax-summary":{"get":{"summary":"Tax Summary","tags":["Reports"],"parameters":[{"name":"year","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"Tax summary"}}}},"/api/v1/company":{"get":{"summary":"Get company info","tags":["Company"],"responses":{"200":{"description":"Company details"}}},"put":{"summary":"Update company info","tags":["Company"],"responses":{"200":{"description":"Company updated"}}}}}}