Send a PDF; get back the same PDF with page numbers printed in the format, position, and numbering style you choose.
See the Number Pages tool page, or the docs index for authentication, the shared request/webhook contract, and the generic error table.
POST /webhooks/trigger — same endpoint and fields as every tool, with tool="number-pages" set explicitly (it's not the default).
curl -X POST https://api.anyconvert.app/webhooks/trigger \ -H "x-api-key: your_api_key_here" \ -F "file=@report.pdf" \ -F "fileId=document-001" \ -F "referenceId=reference-001" \ -F "tool=number-pages"
An optional options multipart field carrying a JSON object, validated synchronously before a credit is charged — a bad value is rejected with 400, not charged and not queued.
| format | string, optional | Default "Page {n} of {total}". Must contain {n}; may contain {total}. Max 100 characters. |
| start | number, optional | The number printed on the first selected page. 1 to 100,000. |
| numbering | string, optional | "arabic" (default), "roman-lower", "roman-upper", "alpha-lower", or "alpha-upper". |
| position | string, optional | Default "bottom-center"; one of 9 anchors with an optional marginPt. |
| font, size, color | optional | Same font allow-list as Watermark PDF. |
| pages | string, optional | Default "all"; the page-selection grammar. Numbers advance by one per selected page, e.g. "2-" leaves page 1 unnumbered and starts counting from page 2. |
| skipFirst | boolean, optional | Leave the first selected page unnumbered. |
Billed per page, not per document — 1 credit for every 20 pages, rounded up.
Delivered via the webhook as outcome=failure with a reason below — see the docs index for the full delivery shape.
| invalid_options | A bad format string, an out-of-range start value, or a page outside the document. |
| invalid_file | The file could not be read, or was not the format this tool expects. |
| render_failed | Something failed during conversion that wasn’t a problem with the input itself. |
| timeout | The job did not finish within its time budget. |
| internal_error | An unexpected error on our side. |