AnyConvert
← All docs

Number Pages

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.

Request

POST /webhooks/trigger — same endpoint and fields as every tool, with tool="number-pages" set explicitly (it's not the default).

curl
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"

Options

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.

formatstring, optionalDefault "Page {n} of {total}". Must contain {n}; may contain {total}. Max 100 characters.
startnumber, optionalThe number printed on the first selected page. 1 to 100,000.
numberingstring, optional"arabic" (default), "roman-lower", "roman-upper", "alpha-lower", or "alpha-upper".
positionstring, optionalDefault "bottom-center"; one of 9 anchors with an optional marginPt.
font, size, coloroptionalSame font allow-list as Watermark PDF.
pagesstring, optionalDefault "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.
skipFirstboolean, optionalLeave the first selected page unnumbered.

Pricing

Billed per page, not per document — 1 credit for every 20 pages, rounded up.

Failure reasons

Delivered via the webhook as outcome=failure with a reason below — see the docs index for the full delivery shape.

invalid_optionsA bad format string, an out-of-range start value, or a page outside the document.
invalid_fileThe file could not be read, or was not the format this tool expects.
render_failedSomething failed during conversion that wasn’t a problem with the input itself.
timeoutThe job did not finish within its time budget.
internal_errorAn unexpected error on our side.
AnyConvert
A simple conversion API for teams that need documents turned into the right format, automatically.
Tools
PDF to WordMerge PDFJPG to PDFSign PDFEdit PDFCompress PDFExtract Text with CoordinatesView all tools →
Product
DocsPricing
Legal
Terms of ServicePrivacy PolicyRefund Policy
Support
support@anyconvert.app
© 2026 AnyConvert. All rights reserved.