> ## Documentation Index
> Fetch the complete documentation index at: https://docs.erp.arukz.com/llms.txt
> Use this file to discover all available pages before exploring further.
# List taxes
> Retrieve a paginated list of taxes with filtering and sorting
## OpenAPI
````yaml /api-reference/openapi.json get /admin/api/v1/accounts/taxes
openapi: 3.0.3
info:
title: ARUKZ ERP API
version: v1
description: >-
The REST API of ARUKZ ERP: sales, purchases, inventory, products, partners,
accounts, projects and reference data. Every call acts as the user whose
token it carries and sees only that user's company.
servers:
- url: https://erp.arukz.com
description: ARUKZ ERP (hosted)
security:
- bearerAuth: []
tags:
- name: Authentication
description: Sign in for a token and sign out.
- name: Sales
description: Quotations, sales orders and their lines, deliveries and invoices.
- name: Purchases
description: Purchase orders, receipts, bills, agreements and vendor price lists.
- name: Inventory
description: >-
Warehouses, locations, lots, stock quantities, receipts, deliveries,
transfers and scrap.
- name: Products
description: 'The product catalogue: categories, attributes, variants and packaging.'
- name: Partners
description: Customers, vendors, contacts, addresses and bank accounts.
- name: Accounts
description: >-
Invoices, bills, credit notes, refunds, taxes, journals and the chart of
accounts.
- name: Projects
description: Projects, tasks, stages and milestones.
- name: Reference data
description: Currencies and rates, banks, countries, states and units of measure.
paths:
/admin/api/v1/accounts/taxes:
get:
tags:
- Accounts
summary: List taxes
description: Retrieve a paginated list of taxes with filtering and sorting
operationId: accounts-taxes-list-taxes
parameters:
- name: include
in: query
required: false
schema:
type: string
description: >-
Comma-separated list of relationships to include.
**Available options:** company, taxGroup,
cashBasisTransitionAccount, country, creator, childrenTaxes,
invoiceRepartitionLines, refundRepartitionLines
example: invoiceRepartitionLines,refundRepartitionLines
description: >-
Comma-separated list of relationships to include.
**Available options:** company, taxGroup,
cashBasisTransitionAccount, country, creator, childrenTaxes,
invoiceRepartitionLines, refundRepartitionLines
- name: filter[id]
in: query
required: false
schema:
type: string
description: Comma-separated list of IDs to filter by
description: Comma-separated list of IDs to filter by
- name: filter[name]
in: query
required: false
schema:
type: string
description: Filter by tax name (partial match)
description: Filter by tax name (partial match)
- name: filter[company_id]
in: query
required: false
schema:
type: integer
description: Filter by company ID
description: Filter by company ID
- name: filter[tax_group_id]
in: query
required: false
schema:
type: integer
description: Filter by tax group ID
description: Filter by tax group ID
- name: filter[country_id]
in: query
required: false
schema:
type: integer
description: Filter by country ID
description: Filter by country ID
- name: filter[type_tax_use]
in: query
required: false
schema:
type: string
description: Filter by tax type usage
enum:
- sale
- purchase
- none
description: Filter by tax type usage
- name: filter[amount_type]
in: query
required: false
schema:
type: string
description: Filter by amount type
enum:
- fixed
- group
- percent
- division
- code
description: Filter by amount type
- name: filter[tax_scope]
in: query
required: false
schema:
type: string
description: Filter by tax scope
enum:
- service
- consu
description: Filter by tax scope
- name: filter[price_include_override]
in: query
required: false
schema:
type: string
description: Filter by price include override
enum:
- default
- tax_included
- tax_excluded
description: Filter by price include override
- name: filter[is_active]
in: query
required: false
schema:
type: boolean
description: Filter by active status
description: Filter by active status
- name: sort
in: query
required: true
schema:
type: string
description: Sort field
example: sort
description: Sort field
- name: page
in: query
required: true
schema:
type: integer
description: Page number
example: 1
description: Page number
responses:
'200':
description: Success
content:
application/json:
example:
data:
- id: 1
type_tax_use: sale
tax_scope: null
amount_type: percent
price_include_override: null
tax_exigibility: on_invoice
name: 15 %
description: CESS 5%
invoice_label: Tax 15 %
invoice_legal_notes: null
amount: '15.0000'
is_active: 1
include_base_amount: 1
is_base_affected: 0
analytic: null
sort: 1
company_id: 1
tax_group_id: 1
cash_basis_transition_account_id: null
country_id: 233
creator_id: 1
created_at: '2026-01-07T11:08:43.000000Z'
updated_at: '2026-01-07T11:08:43.000000Z'
invoice_repartition_lines: []
refund_repartition_lines: []
- id: 1
type_tax_use: sale
tax_scope: null
amount_type: percent
price_include_override: null
tax_exigibility: on_invoice
name: 15 %
description: CESS 5%
invoice_label: Tax 15 %
invoice_legal_notes: null
amount: '15.0000'
is_active: 1
include_base_amount: 1
is_base_affected: 0
analytic: null
sort: 1
company_id: 1
tax_group_id: 1
cash_basis_transition_account_id: null
country_id: 233
creator_id: 1
created_at: '2026-01-07T11:08:43.000000Z'
updated_at: '2026-01-07T11:08:43.000000Z'
invoice_repartition_lines: []
refund_repartition_lines: []
links:
first: /?page=1
last: /?page=1
prev: null
next: null
meta:
current_page: 1
from: 1
last_page: 1
links:
- url: null
label: '« Previous'
active: false
- url: /?page=1
label: '1'
active: true
- url: null
label: Next »
active: false
path: /
per_page: 10
to: 2
total: 2
'401':
description: Unauthenticated
content:
application/json:
example:
message: Unauthenticated.
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: >-
An API token from [Sign in](/api-reference/authentication), sent as
`Authorization: Bearer `. Tokens last 30 days.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.