Get started

Office files that open, every time

The I Hate Corrupt Files API checks and repairs .xlsx, .docx and .pptx files, and the older .xls, .doc and .ppt, which come back as their modern equivalents. Send a file; get back a verdict, whether Office will open it, and every change a repair would make — or the repaired file itself.

Why use it

Code that writes Office files — an LLM, a report builder, openpyxl, python-docx — can produce a file that looks fine to the code and makes Excel say “We found a problem with some content”. Nobody notices until a customer opens it. One call before you ship the file catches that, and a second fixes it.

It is the engine behind the website, so it has the same six repair levels and the same promise: a file that needs nothing comes back byte for byte, and a repaired file is only returned once Microsoft's Open XML SDK accepts it. How repairs work explains the levels.

Endpoints

Every endpoint lives under https://api.ihatecorruptfiles.xyz and takes your key as a bearer token.

curl https://api.ihatecorruptfiles.xyz/v1/check \
  -H "Authorization: Bearer $IHCF_API_KEY" \
  -F file=@report.xlsx
Response · 200
{
  "request_id": "5f0e7c1a-6f42-4f3c-9f0b-2a1d8c7e4b90",
  "format": "xlsx",
  "bytes": 5281,
  "verdict": "needs_repair",
  "opens_in_office": true,
  "repairable": true,
  "repair_level": "SEMANTICS",
  "findings": [],
  "actions": [
    {
      "stage": "semantics",
      "code": "Sem_NumberStoredAsText",
      "fix": "convert-text-to-number",
      "description": "1 cell(s) held a number typed as text…: C2.",
      "part": "xl/worksheets/sheet1.xml",
      "location": null,
      "advisory": false
    }
  ],
  "reason": null,
  "engine_version": "2.0.0"
}

Where to next