---
title: "Generate a prospecting report"
method: POST
path: "/prospecting-reports"
tags: ["Prospecting Reports"]
---

# Generate a prospecting report

`POST /prospecting-reports`

## Request

- Base URL: `https://api.palisade.email`
- URL: `https://api.palisade.email/prospecting-reports`
- Auth: one of:
  - HTTP bearer
  - HTTP basic

Audits each domain against live DNS, renders the email security report as a PDF, and hosts it. The domains are looked up publicly and do not need to be in your account, which is what makes this usable on a prospect. Up to 10 domains per report. The response carries a url anyone with the link can open, good for 90 days; delete the report to stop it resolving sooner.

## Headers

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

## Request body

- object
  - `generated_for` string, required
  - `domains` string[], required
  - `language` 'en' | 'fr'
  - `include_organization_info` boolean
  - `include_bimi` boolean
  - `include_dns_records` boolean
  - `include_potential_loss` boolean
  - `theme` 'light' | 'dark': The skin the report is drawn in: light on paper, or dark on a near-black ground.
  - `currency` 'USD' | 'CAD' | 'EUR' | 'GBP' | 'AUD': The currency every price band in the report is printed in.
  - `deadline_weeks` integer: How many weeks the plan and closing pages give the reader to fix what the report found.

## Response `201`

Created

- ProspectingReport
  - `id` string, uuid, required
  - `generated_for` string, required
  - `language` 'en' | 'fr', required
  - `requested_by` string, required
  - `domains` string[], required
  - `include_organization_info` boolean, required
  - `include_bimi` boolean, required
  - `include_dns_records` boolean, required
  - `include_potential_loss` boolean, required
  - `theme` 'light' | 'dark', required: The skin the report is drawn in: light on paper, or dark on a near-black ground.
  - `currency` 'USD' | 'CAD' | 'EUR' | 'GBP' | 'AUD', required: The currency every price band in the report is printed in.
  - `deadline_weeks` integer, required: How many weeks the plan and closing pages give the reader to fix what the report found.
  - `url` string, uri, required
  - `expires_at` string, date-time, required
  - `expired` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, 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)