# Summary tax

The <a href="https://docs.solidgate.com/billing/taxes/tax-insights/#tax-reports" target="_blank">summary tax report</a> aggregates your tax data into a single file, grouping figures by every unique combination of legal entity, tax location, and processing currency configured in your Solidgate account. It includes key metrics such as taxable turnover, calculated tax amount, and net revenue for each group, giving you a clear, high-level view of your liabilities across jurisdictions.
In a successful response, you receive a link to the file `report_url`.
<blockquote>
<p>The tax data are in a CSV file, which can be found at the link.</p>
</blockquote>

Endpoint: POST /summary
Version: 1.0.0
Security: MerchantID

## Header parameters:

  - `merchant` (string, required)

  - `signature` (string, required)

## Request fields (application/json):

  - `date_from` (string, required)
    Start datetime for the report stated in UTC+0.
    Example: 2025-01-15 11:00:00

  - `date_to` (string, required)
    End datetime for the report stated in UTC+0.
    Example: 2025-06-20 13:00:00

  - `environment` (string)
    Environment for the summary tax report.
- `live` – live environment, containing live data
- `sandbox` – testing environment with non-live data
- `all` – includes data from both live and sandbox environments
    Enum: "live", "sandbox", "all"

## Response 200 fields (application/json):

  - `report_url` (string)
    URL for the report stored on Amazon S3, which needs to be downloaded.
    Example: https://reports.solidgate.com/api/v1/tax/summary/report/tax_summary_250702_140728/download

  - `error` (object, required)
    Error object.

  - `error.code` (string, required)
    Unauthorized access due to invalid credentials.
    Example: 1.01

  - `error.messages` (array, required)
    Array of error messages applied to the decline payment.