# Working with Entities

Entities identify organizations, groups, or sources associated with authorized records.

## Filtering by Entity

Use the `entity` query parameter on supported endpoints:

```text
/v1/icd/videos?entity=Example%20Entity
```

Entity values should match the indexed name. URL-encode spaces and reserved characters.

## Combining Filters

```text
/v1/icd/videos?entity=Example%20Entity&country=USA&date_from=2026-01-01
```

The example values are placeholders.

## Authorization

Entity filters narrow the records already authorized for the API key. They never expand access. An empty result may mean no authorized record matched; it must not be used to infer content outside the caller's scope.

## Best Practices

- Use an exact indexed entity name when known.
- Combine entity, country, and date filters only when each constraint is needed.
- Use Natural Language Search when the indexed name is unknown.
- Use the dedicated Component ID route when an identifier is already known.