Reports

Access your tax compliance reports generated for AADE. Reports are grouped by month or year and include all validated booking data.

GET/reports

Lists all generated reports.

Scoperead

Query Parameters

ParameterTypeDescription
year
integer

Filter by reporting year.

month
integer

Filter by reporting month (1-12).

page
integer

Page number for pagination.

limit
integer

Number of results per page.

Example Response
json
{
  "data": [
    {
      "id": "rep_2026_05",
      "period": {
        "month": 5,
        "year": 2026
      },
      "format": "PDF",
      "booking_count": 24,
      "total_revenue": 3450.5,
      "file_size": 102456,
      "status": "completed",
      "created_at": "2026-06-01T09:00:00Z"
    }
  ]
}
GET/reports/:id/download

Generates a temporary signed download URL for a report.

Scoperead

Response Body

ParameterTypeDescription
download_url
string

Short-lived URL to download the report file.

expires_at
ISO 8601

Timestamp when the download URL expires.

filename
string

Suggested filename for the report.

Link Expiry
Download URLs are signed and expire after **1 hour**. If you need to download the report again after it expires, make a new request to this endpoint.
Example Response
json
{
  "data": {
    "download_url": "https://storage.filoxenos.gr/reports/rep_2026_05.pdf?token=s3_signed_...&expires=...",
    "expires_at": "2026-06-01T10:00:00Z",
    "format": "PDF",
    "filename": "filoxenos_report_2026_05.pdf"
  }
}