# Get your FBR IRIS invoices and notices through an API > Read the purchase invoices waiting on Annex-A, the notices and orders in your Inbox and the returns still in Draft from IRIS with one API call each. A weekly workflow can email you the unclaimed invoices before the monthly sales tax return. Page: https://fous.com/automate/fbr-iris Updated: 2026-11-12 Works with your own FBR IRIS account. Fous is an independent product. ## What you can build on IRIS ### Get purchase invoices for a tax period Opens Load Invoices on the Annex-A (Purchases) tab of the sales tax return for one tax period and reads the invoices your suppliers reported. - Takes: Tax period - Returns: Seller registration number, seller name, invoice type, invoice number, invoice date, value excluding sales tax, sales tax, claimed or not ### Check the Inbox for notices and orders Reads the Inbox on the IRIS dashboard: notices such as 114(3) and orders a Commissioner has passed on your applications. - Takes: Received since (optional) - Returns: Section, title, tax year or period, received date ### List drafts and submitted returns Reads the Draft folder and the Outbox on the IRIS dashboard: which returns and applications are still drafts and which were submitted, and when. - Takes: Folder (Draft or Outbox), tax year (optional) - Returns: Task name, tax period, folder, submission date ### Add a sales invoice in the Sales Ledger Opens Invoice Management, Sales Ledger, Add Invoice, chooses Sales, enters the buyer and invoice details and saves each item. - Takes: Buyer registration number or CNIC, invoice type, invoice number, invoice date, items - Returns: Invoice number, buyer registration number, items saved, total value, sales tax ## Automate IRIS with a workflow A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use. ### Unclaimed purchase invoices before the sales tax return Starts: Every Monday at 9:00 (Asia/Karachi) 1. Get the purchase invoices on Annex-A for last month's tax period. 2. Keep the invoices that are not yet claimed. 3. Email you the list with seller, invoice number, invoice date, value and sales tax. ### New notices and orders from the Inbox Starts: Every weekday at 8:00 (Asia/Karachi) 1. Check the Inbox for notices and orders. 2. Keep the items that were not there on the last run. 3. Post each one, with its section, tax year and received date, to your webhook. ### Returns still in Draft on the 15th Starts: On the 15th of every month at 10:00 (Asia/Karachi) 1. List the tasks in the Draft folder for the current tax year. 2. Keep the sales tax returns and withholding statements. 3. Email you each one with its task name and tax period. You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month. ## Once built, one call from your code Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get purchase invoices for a tax period” would look like. Example request: ``` curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "method": "iris.fbr.gov.pk/get_purchase_invoices", "input": { "tax_period": "2026-10" } }' ``` Example response: ``` { "status": "completed", "data": { "tax_period": "2026-10", "invoices": [ { "seller_registration_number": "1234567", "seller_name": "Acme Traders (Pvt) Ltd", "invoice_type": "Sales Invoice", "invoice_number": "AT-2026-0418", "invoice_date": "2026-10-07", "value_excluding_sales_tax": 250000, "sales_tax": 45000, "claimed": false } ], "currency": "PKR", "count": 1 } } ``` An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request. ## IRIS’s own options FBR's documented integration is Digital Invoicing: your billing software reports each sales invoice to FBR, connected through a licensed integrator. PRAL integrates on demand free of cost, and FBR charges no fee. Returns, statements and the Inbox are worked in IRIS itself, where Excel templates let you upload invoices and withholding statements in bulk. | Option | What it covers | What it takes | | --- | --- | --- | | Digital Invoicing integration | Your e-invoicing software reports sales invoices to FBR. Required for sales tax registered persons since 2025. | A licensed integrator with a valid FBR licence. PRAL does it free of cost on demand; other integrators may charge. | | Excel templates in IRIS help | Sales Invoice, Purchase Invoice, Annex H and Withholding Tax Statement templates, imported into IRIS. | Downloaded from the IRIS help material; filled in and imported by hand. | | IRIS by hand | Declaration (returns and statements), Invoice Management, Inbox, Draft and Outbox, Payment tab with CPRs. | Registration Number, Password and PIN from E-Enrollment. | Read on November 12, 2026: [FBR Digital Invoicing FAQs](https://www.fbr.gov.pk/faqs/173967/173969), [IRIS help material](https://e.fbr.gov.pk/SOP/IRIS/help/index.html), [Iris FAQs](https://e.fbr.gov.pk/SOP/IRIS/Iris_FAQs.pdf). ## Signing in to IRIS IRIS signs you in with your Registration Number (a 13-digit CNIC for individuals, a 7-digit NTN for companies and AOPs) and your Password; a separate PIN verifies a return before submission. A session closes after 15 minutes without activity. With Fous you sign in once through IRIS's own sign-in with your own account: the login is sealed with AES-256, and an expired session is signed back in. ## Worth knowing - **Purchases come from your suppliers' invoices**: When you create a sales tax return, invoices already in IRIS, including third party invoices, load into the annexures. On Annex-A you select invoices and press Claim. - **A supplier's unpaid tax can block your return**: If a buyer or supplier did not submit their return, the unpaid tax shows in Clause 7a of the counterpart's next return, which cannot be submitted until that tax is paid. - **Submitted means final**: Once submitted, a sales tax return is no longer editable. A revised return needs a revision application first, and the Commissioner's order arrives in your Inbox. - **Sales in Annex-C need digital invoices**: Digital invoices are required for all sales reported in Annex-C of the sales tax return. ## More in Government: India and South Asia - [MCA21](https://fous.com/automate/mca21.md) - [Income Tax e-Filing Portal](https://fous.com/automate/income-tax-e-filing-portal.md) - [GST Portal](https://fous.com/automate/gst-portal.md) - [EPFO Unified Portal (Employer)](https://fous.com/automate/epfo-unified-portal-employer.md) - [TRACES](https://fous.com/automate/traces.md) Other industries: [Alloggiati Web](/automate/alloggiati-web), [Portal Empresarial INFONAVIT](/automate/portal-empresarial-infonavit), [Rev360](/automate/rev360), [Cégkapu](/automate/cegkapu), [FCA RegData](/automate/fca-regdata), [DOB NOW](/automate/dob-now). ## Frequently asked questions ### Does FBR IRIS have an API? Not for returns or the Inbox. FBR's documented integration is Digital Invoicing, which reports sales invoices through a licensed integrator; PRAL does it free of cost on demand. Returns, statements and notices are handled in IRIS, with Excel templates to import invoices and withholding statements. ### Why can't I submit my sales tax return in IRIS? One common reason is Clause 7a. If a supplier or buyer did not submit their return, the unpaid tax shows in Clause 7a of your next return, and you cannot submit until that tax is paid. Once paid, it shows in Clause 7c. ### How do I know a return was submitted? The Submit button is disabled, a Submission Date shows on screen and on the printed copy, the Draft Copy watermark is gone, and the return has moved from Draft to the Outbox. ### Can I add purchase invoices before creating the return? Yes. In Invoice Management, Sales Ledger, choose Add Invoice and select Purchases. The invoices load into Annex-A when you create the return, or with Load Invoices if the return already exists. ### Is Fous affiliated with the Federal Board of Revenue? No. Fous is an independent product. You use it with your own IRIS account, and a method reads and does only what that account can. Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of FBR IRIS (Federal Board of Revenue (FBR), Pakistan). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.