---
title: "Generate company dossier"
method: POST
path: "/api/v1/dossier"
tags: ["API v1"]
---

# Generate company dossier

`POST /api/v1/dossier`

## Request

- Base URL: `https://api.rivalize.ai`
- URL: `https://api.rivalize.ai/api/v1/dossier`
- Auth: HTTP bearer

Generate a complete intelligence dossier on a single company. Returns 202 Accepted with a dossier ID for polling.

## Request body

- object
  - `company_url` string, uri, required: The company's primary website URL
  - `company_name` string: Optional company name hint. Improves enrichment accuracy for reviews, Product Hunt, GitHub matching.
  - `depth` 'standard' | 'deep': standard: web scrape + all enrichments (~90s, 3 credits). deep: adds Perplexity deep research (~3min, 10 credits).
  - `format` 'json' | 'html': json: structured profile + synthesis. html: self-contained styled dossier document.

## Response `202`

Default Response

- object
  - `data` object
    - `dossier_id` string
    - `status_url` string
    - `estimated_seconds` number
    - `message` string

## Other responses

- `400`: Default Response
- `402`: Default Response
- `403`: Default Response

---

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