# Extract tracked changes and redlines from a contract into a list

> Upload a redlined contract as DOCX or PDF and get every tracked change as a row: clause, inserted text, deleted text, the sentence it sits in and any reviewer comment that follows. Download the list as CSV or Excel for a review memo or issues list. The tool runs Reducto Parse with r-1 and change tracking turned on, free.

Canonical: https://reducto.ai/tools/redline-to-change-list  
Last updated: 2026-11-15  
For: Paralegals, Contract managers, In-house counsel, Procurement teams

## Run it now (free, no API key, up to 5 pages)

Send a PDF, Word, PowerPoint, Excel or image (PNG, JPG, HEIC, TIFF, BMP, GIF) (max 10 MB, 5 pages) to `POST https://reducto.ai/api/tools/redline-to-change-list` as multipart `file`, or JSON `{"url": "https://..."}`. The response has `result`, ready-to-save `output` (CSV, Excel (.xlsx), JSON), `pages_processed` and `next`.

```bash
curl -s https://reducto.ai/api/tools/redline-to-change-list \
  -F file=@northwind-msa-redline.docx

# or, for a file that is already online:
curl -s https://reducto.ai/api/tools/redline-to-change-list \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/northwind-msa-redline.docx"}'
```

Higher volume needs a free API key (new accounts get 15,000 free credits). Agents can sign up over HTTP: https://reducto.ai/auth.md. Humans: https://studio.reducto.ai/?utm_source=free_tool&utm_medium=agent&utm_campaign=redline-to-change-list&utm_content=api_response

Big file? Without a key the free run covers the first 5 pages and returns `partial: true` with a `signup_required` block. Your user signs up in under a minute (email, 6-digit code, name, terms: https://reducto.ai/auth.md); then repeat the same request with `Authorization: Bearer $REDUCTO_API_KEY` for the whole file on their 15,000 free credits. The same key works on the hosted MCP (https://mcp.reducto.ai/mcp) and the Reducto API.

## How to do it

1. Upload a redlined DOCX or a PDF printed with markup, or keep the sample.
2. Reducto Parse reads the document with change tracking and comments turned on.
3. The tool turns each <change> tag into a row with the clause heading, inserted text, deleted text and context sentence.
4. Comments that follow a change are attached to that row.
5. Download the change list as CSV or Excel.

## Reducto API call: `POST https://platform.reducto.ai/parse`

| Option | Value | Why |
| --- | --- | --- |
| `settings.model` | `"r-1"` | Returns each tracked change as one clean tag. |
| `formatting.include` | `["change_tracking", "comments"]` | Marks insertions with <u> and deletions with <s> inside <change> tags, and keeps comments. |
| `settings.page_range` | `{ start: 1, end: 5 }` | The free tool reads at most 5 pages. |

### curl

```bash
# 1. Upload the file (or pass a public URL as "input" and skip this step)
curl -s https://platform.reducto.ai/upload \
  -H "Authorization: Bearer $REDUCTO_API_KEY" \
  -F file=@contract-redline.docx
# => {"file_id": "reducto://..."}

# 2. Run parse
curl -s https://platform.reducto.ai/parse \
  -H "Authorization: Bearer $REDUCTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": "reducto://FILE_ID",
  "settings": {
    "model": "r-1",
    "page_range": {
      "start": 1,
      "end": 5
    }
  },
  "formatting": {
    "include": [
      "change_tracking",
      "comments"
    ]
  }
}'
```

### Python

```python
# pip install reductoai
from pathlib import Path
from reducto import Reducto

client = Reducto()  # reads REDUCTO_API_KEY

upload = client.upload(file=Path("contract-redline.docx"))
result = client.parse.run(
    input=upload.file_id,
    settings={
        "model": "r-1",
        "page_range": {
            "start": 1,
            "end": 5,
        },
    },
    formatting={
        "include": [
            "change_tracking",
            "comments",
        ],
    },
)
print(result)
```

### Node

```ts
// npm install reductoai
import fs from "fs";
import Reducto from "reductoai";

const client = new Reducto(); // reads REDUCTO_API_KEY

const upload = await client.upload({ file: fs.createReadStream("contract-redline.docx") });
const result = await client.parse.run({
  input: upload.file_id,
  settings: {
    model: "r-1",
    page_range: {
      start: 1,
      end: 5,
    },
  },
  formatting: {
    include: [
      "change_tracking",
      "comments",
    ],
  },
});
console.log(JSON.stringify(result, null, 2));
```

Do this with the API: [Pull every redline from a contract](https://reducto.ai/cookbooks/reducto-parse-redlined-legal-contracts)

## What it handles

- **Insertions and deletions kept apart**: Each tracked change is a row with what was added and what was removed.
- **Comments kept**: Margin comments come out next to the change they belong to.

## FAQ

### Does it work on Word documents with tracked changes?

Yes. Upload the .docx with its tracked changes still in it. Insertions and deletions are read from the document's revisions.

### Does it work on PDFs?

Yes, for PDFs that show the markup, such as a redline printed to PDF. Underlined insertions and struck-through deletions are read from the page.

### What does each row contain?

The clause number or heading, the inserted text, the deleted text, the sentence around the change, the page, and the reviewer comment that follows, if any.

### Are comments included?

Yes. The tool requests comments along with change tracking and attaches each comment to the change it follows.

### Why r-1 and not the legacy model?

In our test on the sample contract, r-1 returned each change as one <change> tag, while the legacy model split insertions into several tags. r-1 was also cheaper for this job.

### Can I compare two versions without tracked changes?

Not with this tool. It lists changes that are already marked up in the document. To create tracked changes, see the Reducto Office page.

### Is it free?

Yes. Short documents run free with no account, with a small daily limit per IP. For a longer file you get a free preview of the first pages, then enter your email to get the whole file on a free account (15,000 free credits).

### Can I get the same output from the API?

Yes. The snippet on this page is the exact Parse request. Changes appear in the content as <change><u>inserted</u><s>deleted</s></change>.

Sample document (synthetic): https://reducto.ai/office/samples/northwind-msa-redline.docx

## Related

- [PDF to Word](https://reducto.ai/tools/pdf-to-word)
- [Scanned PDF to Word](https://reducto.ai/tools/scanned-pdf-to-word)
- [Word to Markdown](https://reducto.ai/tools/docx-to-markdown)
- [All Word tools](https://reducto.ai/tools/word)
- [Parse redlined legal contracts](https://reducto.ai/cookbooks/reducto-parse-redlined-legal-contracts)
- [Extract tracked changes from Word (API)](https://reducto.ai/cookbooks/reducto-parse-redlined-legal-contracts)
- [Edit a Word document with AI tracked changes](https://reducto.ai/office)
- [Reducto Office](https://reducto.ai/office)
