> For the complete documentation index, see [llms.txt](https://docs.rasgoml.com/rasgo-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rasgoml.com/rasgo-docs/rasgo-0.1/pyrasgo-0.3/features/read.feature_data.md).

# read.feature\_data()

### Parameters

**`id`***`:int:`*`ID of Rasgo Collection to return`

**`filters`***`:dict: (Optional)`*`SQL filters to apply to model data`

**`limit`***`:int: (Optional)`*`Number of records to return`

### Return Object

pandas DataFrame

### Sample Usage

Return an entire collection without filters

```python
rasgo = pyrasgo.connect(api_key)

df = pd.DataFrame
df = rasgo.read.feature_data(101)
```

Return a collection with filtered results

```python
df = rasgo.read.feature_data(id=101, 
                             filters={"DATE":"2020-12-25"}
                             )
```

```python
df = rasgo.read.feature_data(id=101, 
                             filters={"DATE":">='2020-12-25'"}
                             )
```

```python
df = rasgo.read.feature_data(id=101, 
                             filters={"DATE":"2020-12-25",
                                      "FIPS":"BETWEEN '0000' AND '2000'"},
                             limit=100
                             )
```

### Best Practices / Tips

{% hint style="info" %}
NOTE: Filter syntax is a pyton dictionary: **{ k : v }**\
Where:\
k= field to apply filter to\
v= valid ANSI sql logic
{% endhint %}

Supported SQL Filters are:

* ">" Greater than
* "<" Less than
* ">=" Greater than or eqaul to
* "<=" Less than or equal to
* "<>" or "!=" Does not equal
* "IN (x,y,z)" In (list)
* "BETWEEN x AND y" Between 2 values