Working with Entities

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

Filtering by Entity

Use the entity query parameter on supported endpoints:

Code
/v1/icd/videos?entity=Example%20Entity

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

Combining Filters

Code
/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.