---
title: JSON object
description: Review the JSON structure for filter and rule objects.
image: https://developers.cloudflare.com/core-services-preview.png
---

> Documentation Index  
> Fetch the complete documentation index at: https://developers.cloudflare.com/firewall/llms.txt  
> Use this file to discover all available pages before exploring further.

[Skip to content](#%5Ftop) 

# JSON object

## Filter object structure and properties

A JSON response for the [Filters API](https://developers.cloudflare.com/api/resources/filters/methods/list/) has this structure:

```

{

  "id": "6f58318e7fa2477a23112e8118c66f61",

  "expression": "http.request.uri.path ~ \"^.*/wp-login.php$\" or http.request.uri.path ~ \"^.*/xmlrpc.php$\"",

  "paused": true,

  "description": "WordPress login paths",

  "ref": ""

}


```

The following table summarizes the object properties:

| Property           | Description                                                                                                                                                                        | Constraints                            |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
| id String          | A UUIDv4 identifier generated by Cloudflare.                                                                                                                                       | Unique, read onlyLength: 32 characters |
| expression String  | A Rules language expression used to evaluate requests. For more information, refer to [Expressions](https://developers.cloudflare.com/ruleset-engine/rules-language/expressions/). |                                        |
| paused Boolean     | Returns true when the filter is not active. Use ref to enable/disable the filter.                                                                                                  | Default: false                         |
| description String | An informative summary of the filter.                                                                                                                                              | Maximum length: 500 characters         |
| ref String         | A short string for tagging filters.                                                                                                                                                | Maximum length: 50 characters          |

```json
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"item":{"@id":"/directory/","name":"Directory"}},{"@type":"ListItem","position":2,"item":{"@id":"/firewall/","name":"Firewall Rules (deprecated)"}},{"@type":"ListItem","position":3,"item":{"@id":"/firewall/api/","name":"Manage rules via the APIs"}},{"@type":"ListItem","position":4,"item":{"@id":"/firewall/api/cf-filters/","name":"Cloudflare Filters API"}},{"@type":"ListItem","position":5,"item":{"@id":"/firewall/api/cf-filters/json-object/","name":"JSON object"}}]}
```