---
title: "Retrieve filtering rule"
method: GET
path: "/filtering-rules/{id}"
tags: ["filtering-rules"]
---

# Retrieve filtering rule

`GET /filtering-rules/{id}`

Retrieves a single filtering rule by ID.

## Path parameters

- `id` string, required

## Headers

- `X-API-Version` string, required

## Response `200`

Filtering rule object.

- 2376818c770704cb8ff0d
  - `data` FilteringRuleResponseDtoV2, required
    - `id` string, required — Auto-generated ID for the filtering rule
    - `name` string, required — Name of the filtering rule
    - `environment` string, required — Environment ID the rule belongs to
    - `expression` string, required — Expression in expr-lang format that defines the rule condition
    - `action` 'allow' | 'deny', required — Action to take when the rule matches
    - `status` 'enabled' | 'disabled', required — Status of the filtering rule
    - `deny_with` string, nullable — Error message to return when denying a request
    - `created_at` string, date-time, required — Date when the rule was created
    - `updated_at` string, date-time, nullable — Date when the rule was last updated

## Other responses

- `400` — Error: Bad request.
- `401` — Error: Invalid API key.
- `403` — Forbidden. Insufficient permissions.
- `404` — Error: Filtering rule with the given ID was not found.
- `422` — Error: Payload parameters are invalid.
- `429` — Error: API key has exceeded its rate limit.

---

[API](https://skmtc.dev/fingerprint/apis/management-api.md) · [All operations](https://skmtc.dev/fingerprint/apis/management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fingerprint/management-api/revisions/b17eccec9d47/schema)