# Retrieves the ruleset by ID.

**GET /deployments/traffic-filter/rulesets/{ruleset_id}**

Retrieves a list of resources that are associated to the specified ruleset.


## Servers
- https://api.elastic-cloud.com/api/v1: https://api.elastic-cloud.com/api/v1 ()



## Parameters

### Path parameters
- **ruleset_id** (string)
  The mandatory ruleset ID.

### Query parameters
- **include_associations** (boolean)
  Retrieves a list of resources that are associated to the specified ruleset.


## Responses
### 200
The container for a set of traffic filter rules.

#### Body: application/json (object)
- **id** (string)
  The ruleset ID
- **name** (string)
  Name of the ruleset
- **description** (string)
  Description of the ruleset
- **type** (string)
  Type of the ruleset
- **include_by_default** (boolean)
  Should the ruleset be automatically included in the new deployments
- **region** (string)
  The ruleset can be attached only to deployments in the specific region
- **rules** (array[object])
  List of rules
- **associations** (array[object])
  List of associations. Returned only when include_associations query parameter is true
- **total_associations** (integer(int32))
  Total number of associations. This includes associations the user does not have permission to view.Returned only when include_associations query parameter is true

### 404
The traffic filter ruleset specified by {ruleset_id} cannot be found. (code: `traffic_filter.not_found`)
#### Headers
- **x-cloud-error-codes** (string)
  The error codes associated with the response

#### Body: application/json (object)
- **errors** (array[object])
  A list of errors that occurred in the failing request

### 500
Error reading the traffic filter ruleset. (code: `traffic_filter.request_execution_failed`)
#### Headers
- **x-cloud-error-codes** (string)
  The error codes associated with the response

#### Body: application/json (object)
- **errors** (array[object])
  A list of errors that occurred in the failing request


[Powered by Bump.sh](https://bump.sh)