> ## Documentation Index > Fetch the complete documentation index at: https://www.commercengine.io/docs/llms.txt > Use this file to discover all available pages before exploring further. # List all invoices > Retrieves a paginated list of tax invoices across all orders. Returns an array of `InvoiceList` objects, each carrying tax-exclusive and tax-inclusive totals plus a GST `tax_summary`. One invoice is raised per shipment, so a multi-shipment order appears as multiple rows. Use `/orders/{order_number}/invoice` to retrieve a single invoice with its line items or as a PDF. ## OpenAPI ````yaml https://openapi.commercengine.io/ce-admin.json get /orders/invoices openapi: 3.1.0 info: title: CE Admin APIs version: '1.0' summary: Comprehensive admin interface for managing your e-commerce platform description: >- Complete administrative API suite for Commerce Engine, providing powerful tools to manage products, orders, customers, inventory, analytics, and system configuration. Designed for administrators and backend integrations requiring full platform control. license: name: All Rights Reserved url: https://www.commercengine.io/contact-us contact: email: support@commercengine.io url: https://www.commercengine.io/contact-us name: Support servers: - url: https://staging.api.commercengine.io/api/v1/{store_id}/admin description: Staging Server variables: store_id: default: store_id description: Store ID - url: https://prod.api.commercengine.io/api/v1/{store_id}/admin description: Prod Server variables: store_id: default: store_id description: Store ID security: - Authorization: [] tags: - name: Analytics description: Analytics - name: Catalog description: Catalog - name: Coupons & promotions description: Coupons & promotions - name: Customers description: Customers - name: Filter Options description: Filter Options - name: Inventories description: Inventories - name: Marketplace description: Marketplace - name: Marketplace Catalog description: Marketplace Catalog - name: Media Gallery description: Media Gallery - name: Metrics description: Metrics - name: Orders description: Orders - name: Payments description: Payments - name: Payouts description: Payouts - name: POS description: POS - name: POSAdmin description: Admin endpoints to be used as proxy in pos - name: Segments description: Segments - name: Shipping description: Shipping - name: SSE description: SSE - name: Store description: Store - name: Webhooks description: Webhooks paths: /orders/invoices: get: tags: - Orders summary: List all invoices description: >- Retrieves a paginated list of tax invoices across all orders. Returns an array of `InvoiceList` objects, each carrying tax-exclusive and tax-inclusive totals plus a GST `tax_summary`. One invoice is raised per shipment, so a multi-shipment order appears as multiple rows. Use `/orders/{order_number}/invoice` to retrieve a single invoice with its line items or as a PDF. operationId: list-invoices parameters: - $ref: '#/components/parameters/pageNumber' - $ref: '#/components/parameters/pageLimit' - $ref: '#/components/parameters/columnBasedFilters' - $ref: '#/components/parameters/sortByOptions' - $ref: '#/components/parameters/searchKeyword' responses: '200': description: OK content: application/json: schema: type: object properties: message: type: string success: type: boolean content: properties: invoices: type: array items: $ref: '#/components/schemas/InvoiceList' pagination: $ref: '#/components/schemas/Pagination' type: object components: parameters: pageNumber: name: page in: query required: false schema: type: integer default: 1 minimum: 1 description: page number of pagination list pageLimit: name: limit in: query required: false schema: type: integer default: 25 minimum: 1 description: no of rows per page columnBasedFilters: name: filters in: query required: false schema: type: string example: >- {"condition":"AND","filters":[{"type":"data","field":"status","operator":"equals","value":"success"}]} description: JSON object sortByOptions: name: sort_by in: query required: false schema: description: >- json string in format {'field_name':'asc', 'other_field_name':'desc', ...} type: string description: 'JSON string format: {"field1":"asc", "field2":"desc"}' searchKeyword: name: search in: query required: false schema: type: string description: search keyword schemas: InvoiceList: title: InvoiceList description: >- A single invoice row in the invoice listing. Each invoice is raised against one shipment of an order, so an order with multiple shipments produces multiple invoices. type: object required: - invoice_number - invoice_date - invoice_source - order_number - shipment_id - customer_id - customer_name - items_count - subtotal - subtotal_including_tax - shipping_amount_excluding_tax - shipping_amount_including_tax - shipping_tax_rate - shipping_tax_amount - total_tax - invoice_amount_excluding_tax - invoice_amount_including_tax - tax_summary - created_at - modified_at properties: invoice_number: description: Seller-scoped invoice number printed on the tax invoice. type: string invoice_date: description: >- Date of supply printed on the invoice. May differ from `created_at`, which records when the invoice was generated. type: string format: date invoice_source: description: >- Party that raised the invoice. `default` for invoices raised by the store itself; `seller` for invoices raised by a marketplace seller. type: string enum: - default - seller order_number: type: string shipment_id: description: Identifier of the shipment this invoice was raised for. type: string seller_id: description: >- Seller who raised the invoice. `null` when `invoice_source` is `default`. type: - string - 'null' seller_details: description: >- Registered details of the seller identified by `seller_id`. `null` when `invoice_source` is `default`. oneOf: - $ref: '#/components/schemas/SellerInfo' - type: 'null' customer_id: type: string customer_name: type: string items_count: description: Number of line items on the invoice. type: integer irn_number: description: >- Invoice Reference Number returned by the GST e-invoicing portal. `null` if the invoice has not been registered. type: - string - 'null' ack_number: description: >- Acknowledgement number issued by the GST e-invoicing portal. `null` until the invoice is registered. type: - string - 'null' ack_date: description: >- When the GST e-invoicing portal acknowledged the invoice. `null` until the invoice is registered. type: - string - 'null' format: date-time gatepass_barcode: description: >- Barcode scanned at warehouse dispatch. `null` if no gatepass was issued. type: - string - 'null' subtotal: description: Line-item total before tax and shipping. type: number format: double subtotal_including_tax: description: Line-item total including tax, before shipping. type: number format: double shipping_amount_excluding_tax: description: Shipping charged on this invoice, before tax. type: number format: double shipping_amount_including_tax: description: Shipping charged on this invoice, including tax. type: number format: double shipping_tax_rate: description: GST rate applied to shipping, as a percentage. type: number format: double shipping_tax_amount: description: Tax levied on the shipping amount. type: number format: double coupon_code: description: Coupon applied to the invoiced items. `null` if none was applied. type: - string - 'null' coupon_discount_amount: description: Discount attributed to `coupon_code` on this invoice. type: number format: double total_tax: description: Total tax on the invoice, across items and shipping. type: number format: double invoice_amount_excluding_tax: description: Invoice total before tax, after discounts and shipping. type: number format: double invoice_amount_including_tax: description: >- Amount payable on the invoice. This is the figure printed as the invoice total. type: number format: double tax_summary: description: >- GST breakdown grouped by tax rate. Intra-state supplies populate `cgst` and `sgst`; inter-state supplies populate `igst`. type: array items: type: object required: - tax_rate - taxable_value - igst - cgst - sgst properties: tax_rate: description: GST rate for this group, as a percentage. type: number format: double taxable_value: description: Value taxed at `tax_rate`. type: number format: double igst: description: Integrated GST on `taxable_value`. type: number format: double cgst: description: Central GST on `taxable_value`. type: number format: double sgst: description: State GST on `taxable_value`. type: number format: double created_at: type: string format: date-time modified_at: type: string format: date-time x-tags: - Orders Pagination: title: Pagination description: pagination metadata structure type: object properties: total_records: type: integer total_pages: type: integer previous_page: description: Previous page number type: - integer - 'null' limit: type: integer default: 25 next_page: description: Next page number type: - integer - 'null' SellerInfo: title: SellerInfo type: object properties: id: type: string trade_name: type: string legal_name: type: string business_type: $ref: '#/components/schemas/SellerBusinessType' tax_identification_number: type: string status: $ref: '#/components/schemas/SellerAccountStatus' kyc_status: $ref: '#/components/schemas/SellerKycStatus' visibility: description: >- Visibility of the products of the seller. public: products are visible to all users, private: products are visible to only authenticated users. type: string enum: - public - private logo: type: - string - 'null' SellerBusinessType: title: SellerBusinessType type: string enum: - sole_proprietorship - private_limited - public_listed - public_limited - state_owned - charity - individual SellerAccountStatus: title: SellerAccountStatus type: string enum: - pending_approval - approved - rejected SellerKycStatus: title: SellerKycStatus type: string enum: - document_pending - document_submitted - approved - rejected securitySchemes: Authorization: type: http scheme: bearer ````