Endpoints

To invoke a Cloudflare Filters API operation, append the endpoint to the Cloudflare API base URL:

https://api.cloudflare.com/client/v4/

For authentication instructions, refer to Getting Started: Requests in the Cloudflare API documentation.

For help with endpoints and pagination, refer to Getting Started: Endpoints.

Note

The Filters API endpoints require a value for <ZONE_ID>.

To retrieve a list of zones associated with your account, use the List Zones operation and note the Zone ID associated with the domain for which you want to manage filters.

The Cloudflare Filters API supports the operations outlined below. Visit the pages in this section for examples.

Operation	Method & Endpoint	Notes
Create filters	POST zones/<ZONE_ID>/filters	Handled as a single transaction. If there is an error, the entire operation fails.
Get filters	GET zones/<ZONE_ID>/filters	Lists all current filters. Results return paginated with 25 items per page by default. Use optional parameters to narrow results.
Get a filter	GET zones/<ZONE_ID>/filters/<FILTER_ID>	Retrieve a single filter by ID.
Update filters	PUT zones/<ZONE_ID>/filters	Handled as a single transaction. All filters must exist for operation to succeed. If there is an error, the entire operation fails.
Update a filter	PUT zones/<ZONE_ID>/filters/<FILTER_ID>	Update a single filter by ID.
Delete filters	DELETE zones/<ZONE_ID>/filters	Delete existing filters. Must specify list of filter IDs. Empty requests result in no deletion. Returns HTTP status code 200 if a specified filter does not exist.
Delete a filter	DELETE zones/<ZONE_ID>/filters/<FILTER_ID>	Delete a filter by ID.