The pfSense REST API package is an unofficial, open-source REST API for pfSense CE and pfSense Plus firewalls. This package is designed to be light-weight, fast, and easy to use. This guide will help you get started with the REST API package and provide you with the information you need to configure and use the package effectively.
- 100+ endpoints available for managing your firewall and associated services
- Easy to use querying and filtering
- Configurable security settings
- Supports HATEOAS driven development
- Customizable authentication options
- Built-in Swagger documentation
- Installation and Configuration
- Authentication and Authorization
- Swagger and OpenAPI
- Queries and Filters
For new users, it is recommended to refer to the links in the Getting Started section to begin. Otherwise, the installation commands are included below for quick reference.
Install on pfSense CE:
pkg-static add https://github.com/jaredhendrickson13/pfsense-api/releases/latest/download/pfSense-2.7.2-pkg-RESTAPI.pkg
Install on pfSense Plus:
pkg-static -C /dev/null add https://github.com/jaredhendrickson13/pfsense-api/releases/latest/download/pfSense-24.03-pkg-RESTAPI.pkg
Important
You may need to customize the installation command to reference the package built for your pfSense version. Check the releases page to find the package built for your version of pfSense.
Caution
This package is not affiliated or supported by Netgate or the pfSense team. This package is developed and maintained by the community.