Skip to main content
The profiles list endpoint supports query parameters to filter results by tags, gender, and other fields. Use filters to find matching profiles for bulk operations, segmentation checks, or integration lookups.
This page covers the Profile-specific cases. For the operator reference, sorting, paging, and the shared search, search_with, custom_field, and json_contains filters that every list endpoint accepts, see Filtering, sorting, and search.

​
Basic request

Without filters this returns all profiles, paginated. Add query parameters to narrow results.

​
Filtering by tag

Tags live on a related record, so filter on tags.handle rather than tags.
Use the in operator with a comma separated list to match Profiles carrying any of the listed tags. Use not_has to exclude them instead.
Statuses work the same way through filter[statuses.handle].

​
Filtering by gender

​
Filtering by identity

Find the Profile behind an external system’s ID without knowing the Omneo id.

​
Combining filters

Multiple filter parameters are combined with AND logic, a profile must match all supplied filters to appear in results.
Omneo drops filters on attributes it does not recognise instead of returning an error. A filter on tags rather than tags.handle returns unfiltered results. The full list of attributes this endpoint accepts is on Browse profiles.

​
Pagination

The response includes a meta.pagination object:
Use page[number]=2, page[number]=3, and so on to retrieve subsequent pages. Set page[size] to control result size. It defaults to 15, and values of 999 or higher are capped at 999.