Skip to content

About

PDF Page Numbers stamps a page number on every page of a PDF, uploaded or fetched from a URL, and returns a download link to the numbered file. Choose the corner or edge and the font size. Paid plans can also set a label format such as Page 3 of 12, the starting number, and skip a cover page.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

14 Commits

Folders and files

Repository files navigation

PDF Page Numbers stamps a page number on every page of a PDF, uploaded or fetched from a URL, and returns a download link to the numbered file. Choose the corner or edge and the font size. Paid plans can also set a label format such as Page 3 of 12, the starting number, and skip a cover page.

The PDF Page Numbers API provides a simple, reliable way to integrate pdf page numbers functionality into your applications. Built for developers who need production-ready pdf page numbers capabilities without the complexity of building from scratch.

View API Details β†’

License: MIT API Status Method Platform

Available on: npm NuGet PyPI RubyGems Packagist Go Dart JitPack


Quick Start

Using JavaScript

async function callPDFPageNumbersAPI() {
    try {
        const requestBody = {
    "format": "Page {page} of {total}",
    "pdf": "https://raw.githubusercontent.com/mozilla/pdf.js/master/test/pdfs/rotation.pdf"
};

        const response = await fetch('https://api.apiverve.com/v1/pdfpagenumbers', {
            method: 'POST',
            headers: {
                'x-api-key': 'YOUR_API_KEY_HERE',
                'Content-Type': 'application/json'
            },
            body: JSON.stringify(requestBody)
        });

        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callPDFPageNumbersAPI();

Using cURL

curl -X POST "https://api.apiverve.com/v1/pdfpagenumbers" \
  -H "x-api-key: YOUR_API_KEY_HERE" \
  -F "pdf=@/path/to/your-file"
# Accepted formats: .pdf (max 10MB)

Get your API key: https://apiverve.com

πŸ“ For more examples, see the examples folder


Installation

Choose your preferred programming language:

πŸ“¦ NPM (JavaScript/Node.js)

npm install @apiverve/pdfpagenumbers

View NPM Package β†’ | Package Code β†’


πŸ”· NuGet (.NET/C#)

dotnet add package APIVerve.API.PDFPageNumbers

View NuGet Package β†’ | Package Code β†’


🐍 Python (PyPI)

pip install apiverve-pdfpagenumbers

View PyPI Package β†’ | Package Code β†’


πŸ’Ž Ruby (RubyGems)

gem install apiverve_pdfpagenumbers

View RubyGems Package β†’ | Package Code β†’


🐘 PHP (Packagist)

composer require apiverve/pdfpagenumbers

View Packagist Package β†’ | Package Code β†’


🎯 Dart (pub.dev)

dart pub add apiverve_pdfpagenumbers

View pub.dev Package β†’ | Package Code β†’


πŸ€– Android (JitPack)

implementation 'com.github.apiverve:pdfpagenumbers-api:1.0.0'

Package Code β†’


🐹 Go

go get github.com/apiverve/pdfpagenumbers-api/go

Package Code β†’


Why Use This API?

Feature Benefit
Multi-language SDKs Native packages for JavaScript, Python, C#, Go, and Android
Simple Integration Single API key authentication, consistent response format
Production Ready 99.9% uptime SLA, served from 24 global regions
Comprehensive Docs Full examples, OpenAPI spec, and dedicated support

Documentation


What Can You Build?

The PDF Page Numbers API is commonly used for:

  • Web Applications - Add pdf page numbers features to your frontend or backend
  • Mobile Apps - Native SDKs for Android development
  • Automation - Integrate with n8n, Zapier, or custom workflows
  • SaaS Products - Enhance your product with pdf page numbers capabilities
  • Data Pipelines - Process and analyze data at scale

API Reference

Authentication

All requests require an API key in the header:

x-api-key: YOUR_API_KEY_HERE

Get your API key: https://apiverve.com

Response Format

Every APIVerve endpoint returns the same envelope β€” check status, then read data:

{
  "status": "ok",
  "error": null,
  "data": { ... }
}

Example Response

A real response from the PDF Page Numbers API:

{
  "status": "ok",
  "error": null,
  "data": {
    "pdfName": "5c9f95f9-9719-47c3-a923-be3bc1f1dc91.pdf",
    "pageCount": 2,
    "numberedPages": 2,
    "position": "bottom-center",
    "format": "Page {page} of {total}",
    "startAt": 1,
    "lastLabel": "Page 2 of 2",
    "size": 6218,
    "expires": 1792230037933,
    "downloadURL": "https://storage.googleapis.com/apiverve/APIData/pdfpagenumbers/5c9f95f9-9719-47c3-a923-be3bc1f1dc91.pdf?GoogleAccessId=635500398038-compute%40developer.gserviceaccount.com&Expires=1792230037&Signature=a2sCOtSuSIIEWobe8wq5iHcCdqlJMXhrHE9ewxXsf7qrNBK3NHtxrQYk%2Fn1Jpr08aQBVtJclbKX6CFqRigV2IL4suv%2F%2B8WF9LRX%2BhY%2Frhvkw9RfdydlsvALhpPxnxv547eShgBIsuwvEOPFry%2F1J%2FCvt3X%2BT8Iwpz9EtJJVKH8C3u8u26%2FlNjj7XcRCqx6hcVIWvkJEVuZfMQUjlcbtF4IOwvITwlIQW9ChPzMIlXdXu2amBIy9PinQoKsdVopBfTre4W%2BTH6%2BgynWlvnJAHmxM6mWdfLQxTjCyFzdT4ZmJuq%2BRM36d41N62KxiTGyP1cs0YJECt36nI3a7FTzUOrA%3D%3D"
  }
}

Support & Community


Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.


Security

For security concerns, please review our Security Policy.


License

This project is licensed under the MIT License - see the LICENSE file for details.


Acknowledgments

Built with ❀️ by APIVerve

Copyright Β© 2026 APIVerve. All rights reserved.

About

PDF Page Numbers stamps a page number on every page of a PDF, uploaded or fetched from a URL, and returns a download link to the numbered file. Choose the corner or edge and the font size. Paid plans can also set a label format such as Page 3 of 12, the starting number, and skip a cover page.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages