---
title: "Export situations"
method: GET
path: "/v1/situations/export"
tags: ["Special Situations"]
---

# Export situations

`GET /v1/situations/export`

## Request

- Base URL: `https://api.turos.app`
- URL: `https://api.turos.app/v1/situations/export`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Enqueue an async bulk Special Situations export from the same snapshot/issue renderer (JSON, CSV, Excel, PDF, or Copy-for-LLM).

## Query parameters

- `types` string
- `subtypes` string
- `statuses` string
- `tickers` string
- `sectors` string
- `market_cap` string
- `market_cap_min` number
- `market_cap_max` number
- `ev` string
- `country` string
- `announced_from` string
- `announced_to` string
- `updated_from` string
- `updated_to` string
- `forms` string
- `enrich` 'true' | 'false'
- `cursor` integer
- `limit` integer
- `response_mode` 'compact' | 'standard' | 'verbose' | 'agent'
- `format` 'json' | 'csv' | 'xlsx' | 'pdf' | 'llm' | 'excel' | 'markdown' | 'md'
- `issue` string
- `situation_id` string

## Response `202`

Queued export job. Poll GET /v1/exports/{job_id} or wait for export.completed.

- ExportJob
  - `object` 'export_job', required
  - `jobId` string, required
  - `status` 'queued' | 'running' | 'completed' | 'failed', required
  - `dataset` 'company_overview' | 'macro_observations' | 'situations', required
  - `format` 'json' | 'csv' | 'xlsx' | 'pdf' | 'llm', required
  - `rowCount` integer, required
  - `byteSize` integer, required
  - `downloadUrl` string, nullable, required
  - `expiresAt` string, nullable, required
  - `contentHash` string, nullable
  - `revisionId` string, nullable
  - `replayed` boolean
  - `errorText` string

## Other responses

- `default`: Contract-aware error response

---

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