---
title: "Filing comparison"
method: GET
path: "/v1/filings/diff"
---

# Filing comparison

`GET /v1/filings/diff`

## Request

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

Compares a selected issuer filing with a prior-period or explicitly chosen counterpart and returns section-level change information. Any comparison is a review aid based on rendered filing text, not a determination of materiality or legal significance.

## Query parameters

- `ticker` string, required
- `form` string, required
- `from` string
- `to` string
- `sections` string
- `include_hunks` 'true' | 'false'
- `response_mode` 'compact' | 'standard' | 'verbose' | 'agent'

## Response `default`

Contract-aware error response

- Error
  - `object` 'error', required
  - `id` string, required
  - `code` string, required
  - `type` string, required
  - `message` string, required
  - `requestId` string, required
  - `traceparent` string
  - `hint` string
  - `docsUrl` string, uri
  - `details` object, required

## Other responses

- `404`: Returned when filing intelligence is not enabled for the requesting account (`filings_intelligence_not_available`). This is an account entitlement, not the endpoint's availability.

---

[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)