---
title: "List TLS-RPT reports"
method: GET
path: "/domains/{domainId}/tls-reports"
tags: ["TlsReport"]
---

# List TLS-RPT reports

`GET /domains/{domainId}/tls-reports`

## Request

- Base URL: `https://api.palisade.email`
- URL: `https://api.palisade.email/domains/{domainId}/tls-reports`
- Auth: one of:
  - HTTP bearer
  - HTTP basic

List the TLS-RPT reports sending servers have submitted for this domain. Reports only arrive once the domain publishes an MTA-STS policy and a TLS-RPT record.

## Path parameters

- `domainId` string, uuid, required

## Query parameters

- `page` number
- `per_page` number
- `date_from` string, date
- `date_to` string, date
- `sort_by` 'day' | 'total_successful' | 'total_failure' | 'organization_name'
- `sort_order` 'desc' | 'asc'

## Headers

- `Palisade-Version` '2025-04-30' | 'unstable', required

## Response `200`

Success

- object
  - `data` object[], required
    - `id` string, required
    - `hostname_id` string, required
    - `report_id` string, required
    - `organization_name` string, required
    - `contact_info` string, nullable, required
    - `date_range_start` string, required
    - `date_range_end` string, required
    - `day` string, required
    - `policy_type` string, required
    - `policy_domain` string, required
    - `mx_host` string, nullable, required
    - `total_successful` number, required
    - `total_failure` number, required
    - `created_at` string, required
    - `failures` object[], required
      - `result_type` string, required
      - `sending_mta_ip` string, nullable, required
      - `receiving_ip` string, nullable, required
      - `receiving_mx_hostname` string, nullable, required
      - `failed_session_count` number, required
      - `additional_info` string, nullable, required
      - `failure_reason_code` string, nullable, required
  - `page_info` object, required
    - `count` number, required
    - `page` number, required
    - `per_page` number, required

---

[API](https://skmtc.dev/palisade/apis/palisade-api.md) · [All operations](https://skmtc.dev/palisade/apis/palisade-api/llms.txt) · [OpenAPI document](https://skmtc.dev/palisade/apis/palisade-api/revisions/37b4ae5a7766?raw)