Guides

Scan to Word or Excel API

Turn scans into editable Office files. Tool id scan-to-office; runs on our servers through POST /tasks.

At a glance#

PropertyValue
Tool idscan-to-office
Accepts.pdf
Files per taskAt least 1; at most 1 on Pro, 1 on Business
Largest file500 MB on Pro, 500 MB on Business
PlanEvery plan with API access
ResultSet by the format option (docx or xlsx)

Accepted MIME types: application/pdf.

Options#

Put options in data.options. Missing options take their defaults; a value outside the allowed range answers 400 (see Errors).

OptionTypeDefaultAllowed valuesRequired
formatstring"docx"one of: docx, xlsxNo
languagesarray of strings["eng"]any of: eng, fra, deu, spa, por, ita, nld, ara, hin, jpn, chi_sim, rus, tur, vie, ind, ben, tel, tam, mar, urd, swa, fil, chi_tra, kor, pol, ukr, heb, msa, bul, cat, ell, sweNo

Allowances and credits#

  • Each page counts against your monthly cloud OCR pages; beyond the allowance each page costs 1 credit.
  • Each file counts as one Office conversion; beyond the allowance each conversion costs 2 credits.

Build a request#

Upload the file as files[] and the tool and options as a JSON string in data. Change the options below and the request follows; only values that differ from the defaults are sent. Set MACAAW_API_KEY to a sandbox key while you build (see Quickstart).

Default "docx"
languages (1 chosen)
Default ["eng"]

Sent options: {}

curl https://macaaw.com/public/v1/tasks \
  -H "Authorization: API-Key $MACAAW_API_KEY" \
  -F "files[]=@report.pdf;type=application/pdf" \
  -F 'data={"tool":"scan-to-office","options":{}}'
201 Created
{
  "id": "3f0c9a52-6d1e-4c8b-a1f4-0e7d2b9c8a11",
  "tool": "scan-to-office",
  "status": "task.queued",
  "state": "queued",
  "error": null,
  "input_size": 4831022,
  "output_size": null,
  "output_files": null,
  "stats": null,
  "sandbox": false,
  "date_created": "2026-10-30T11:35:00.000000Z",
  "date_completed": null,
  "expires_at": null
}

Then poll the task or wait for the task_completed webhook, and download the result. When a task produces several files, the download is a ZIP.

Sandbox tasks are free and never counted: they process at most 5 pages and their output is stamped. Live tasks count against your plan like tasks on the website.

Try it without code on the website: Scan to Word or Excel.

Scan to Word or Excel API · Macaaw API