Tax Details Report

Production

GET

/api2/reports/tax_details

Every taxed line behind the tax figures, per tax: sales invoices, advance payments, debit notes, returns, purchases, income, expenses and asset movements, each section with its subtotal and each tax with its NET. Mirrors /owner/reports/taxes?details=1.

Figures are signed as the page prints them: sales returns, purchase invoices, expenses and asset purchases are negative; purchase returns and purchase debit notes are positive. totals.net and each block's net are the page's NET rows.

Bounded: a report with more rows than the endpoint will assemble (20,000 by default) is a 400; narrow it with the dates, tax_id or branch_id.

Request

Authorization

OAuth 2.0

Password

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: https://www.daftra.com/v2/oauth/token

API Key

Add parameter in header

apikey

Example:

apikey: ********************

API Key

Add parameter in cookie

OISystem

Example:

OISystem: ********************

Query Params

Header Params

Responses

🟢200

application/json

The report.

Bodyapplication/json

🟠400Error400

🟠401Error401

🟠403Error403

🟠404Error404

🟠405Error405

🔴500Error500

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api2/reports/tax_details?date_from=2026-01-01&date_to=2026-03-31&tax_id=&invoice_type=&group_by=&currency=&branch_id=&show_not_taxed=' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ' \
--header 'apikey: ' \
--header 'Content-Type: application/json'

Response Example

200 - Example 1

{
    "result": "successful",
    "code": 200,
    "data": {
        "report": {
            "key": "tax_details",
            "title": "string",
            "currency": "string"
        },
        "filters": {
            "date_from": "2019-08-24",
            "date_to": "2019-08-24",
            "tax_id": 0,
            "invoice_type": "accrual",
            "group_by": "item",
            "currency": -1,
            "branch_id": [
                0
            ],
            "show_not_taxed": true
        },
        "columns": [
            {
                "key": "string",
                "label": "string"
            }
        ],
        "taxes": [
            {
                "tax_id": 0,
                "name": "string",
                "rate": 0,
                "label": "string",
                "sections": [
                    {
                        "key": "sales_invoices",
                        "title": "string",
                        "rows": [
                            {
                                "document_type": "invoice",
                                "document_id": 0,
                                "number": "string",
                                "po_number": "string",
                                "counterparty": {
                                    "name": "string",
                                    "bn1": "string",
                                    "bn1_label": "string",
                                    "bn2": "string",
                                    "bn2_label": "string"
                                },
                                "date": "2019-08-24",
                                "item": "string",
                                "description": "string",
                                "taxable_amount": 0,
                                "tax": 0
                            }
                        ],
                        "subtotal": {
                            "taxable_amount": 0,
                            "tax": 0
                        }
                    }
                ],
                "net": {
                    "taxable_amount": 0,
                    "tax": 0
                }
            }
        ],
        "totals": {
            "net": {
                "taxable_amount": 0,
                "tax": 0
            }
        },
        "meta": {
            "taxes_count": 0,
            "net_row_shown_on_page": true,
            "rows": 0
        }
    }
}

Balance Sheet Report

Tax Summary Report