---
title: "get recievers by runtime filter. 🔐"
method: POST
path: "/v3/receivers/filter"
tags: ["receivers"]
---

# get recievers by runtime filter. 🔐

`POST /v3/receivers/filter`

returns a list of receivers, filtered by a temporary filter<br/> <br/> <strong>Example Post Data:</strong><br/> <code> {<br/> &nbsp;&nbsp;&nbsp;"groups": ["1","2","3"],<br/> &nbsp;&nbsp;&nbsp;"operator": "OR",<br/> &nbsp;&nbsp;&nbsp;"rules": [<br/> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ "field":"email", "logic":"contains", "condition":"@gotham.com" },<br/> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ "field":"activated", "logic":"bg", "condition":"1234567" },<br/> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ "field":"firstname", "logic":"eq", "condition":"bruce" },<br/> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ "field":"lastname", "logic":"eq", "condition":"gordon" }<br/> &nbsp;&nbsp;&nbsp;],<br/> &nbsp;&nbsp;&nbsp;"orderby": "activated desc",<br/> &nbsp;&nbsp;&nbsp;"detail": 0,<br/> &nbsp;&nbsp;&nbsp;"pagesize": 250,<br/> &nbsp;&nbsp;&nbsp;"page": 0<br/> }<br/> </code> <br/> <hr/> <br/> <strong>Available Logics</strong><br/> <ol> <li>eq&nbsp;&nbsp;(equals)</li> <li>neq&nbsp;&nbsp;(not equals)</li> <li>sm&nbsp;&nbsp;(smaller)</li> <li>bg&nbsp;&nbsp;(bigger)</li> <li>isnull&nbsp;&nbsp;(is empty)</li> <li>notisnull&nbsp;&nbsp;(not empty)</li> <li>contains&nbsp;&nbsp;(contains given string)</li> <li>begins&nbsp;&nbsp;(begins with)</li> <li>ends&nbsp;&nbsp;(ends with)</li> <li>ismale&nbsp;&nbsp;(given field is male)</li> <li>isfemale&nbsp;&nbsp;(given field is female)</li> </ol> <br/> <strong>General available fields</strong><br/> <ol> <li>email - <small>(email of the receiver)</small></li> <li>source - <small>(import source of the email)</small></li> <li>imported - <small>(timestamp of receiver import)</small></li> <li>registered - <small>(timestamp of receiver registration)</small></li> <li>activated - <small>(timestamp of receiver activation)</small></li> <li>deactivated - <small>(timestamp of receiver deactivation)</small></li> <li>bounced - <small>(timestamp of receiver bounce)</small></li> <li>points - <small>(points of the receiver)</small></li> <li>last_location - <small>(last location of receiver)</small></li> <li>last_client - <small>(last mail client used by receiver)</small></li> <li>crevent_mail_send (logic: eq, condition: mailing_id -> receiver of certain mailing)</li> <li>crevent_mail_open (logic: eq, condition: mailing_id -> opened mail of certain mailing)</li> <li>crevent_mail_click (logic: eq, condition: mailing_id -> clicked on mail of certain mailing)</li> <li>crevent_mail_bounce (logic: eq, condition: mailing_id -> bounced mail of certain mailing)</li> <li>all attributes (if global and group attributes have the same name, group ones will be favoured)</li> </ol> <br/>

## Request body

- FilterRuntimeFilterModel
  - `rules` string[], required — Array of rules
  - `groups` string[] — Array of groups - leave empty for all available groups
  - `operator` string — Default operator to combine rules (default: AND)
  - `orderby` string — Order by given Field f.e. "registered DESC". only 1 possible
  - `detail` integer — Detail depth (bitwise combinable) (0: none, 1: events, 2: orders, 4: tags)
  - `pagesize` integer — Pagesize (default: 50)
  - `page` integer — Page (default: 0)
  - `activeonly` boolean — ActiveOnly (default: false) if true, it will only return active subscribers
  - `last_poolid` string — returns only receivers where the ID is higher then this one. (default: "")
  - `inactive_events` boolean
  - `super_tags` string
  - `fast_mode` string
  - `debug` string

## Response `200`

Success

- string[]

---

[API](https://skmtc.net/cleverreach/apis/cleverreach-rest-api.md) · [All operations](https://skmtc.net/cleverreach/apis/cleverreach-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cleverreach/cleverreach-rest-api/versions/7248a065f67f/schema)