Home
API reference
Platform API reference
Platform API
Filters
Get subscription filters

Get subscription filters

get/v0/subscriptions/{subscriptionId}/filters
Page View

Filters endpoints allow you to review or manage filters. You can define a filter with multiple rules for asynchronous messages. You may have one filter defined per subscription. Learn about filters.

You can retrieve, create, update, or delete filters.

Get subscription filters

Retrieve a list of filter rules applied to the specified subscription. You may only apply one filter to a subscription, but the filter may have multiple rules defined.

Request parameters

cURL request example

bash
1
curl 'https://api.redoxengine.com/platform/v0/subscriptions/{subscriptionId}/filters' \
2
--request GET \
3
--header 'Authorization: Bearer $API_TOKEN' \
4
--header 'accept: application/json'

Path Parameters

  • subscriptionId
    required, string

    Displays the unique identifier of the subscription that the filter is applied to.

Query Parameters

  • showDeleted
    boolean

    Indicates that any previously deleted filters (including older versions of filters) should be included in the query response.

Response fields and example

Example payload generated from schema
1
{
2
  "payload": {
3
    "filters": [
4
      {
5
        "id": "09a85196-2760-4296-b874-59d0cdbb7bc4",
6
        "filterVersion": 1,
7
        "createdAt": "2021-03-08T18:10:37.555Z",
8
        "updatedAt": "2021-03-08T18:17:16.719Z",
9
        "version": "1.0.0",
10
        "name": "Filter name",
11
        "organizationId": 122,
12
        "environmentId": "fd1d07e0-1fd2-410f-b57e-e51ac208e7e9",
13
        "action": "send",
14
        "creatingUserId": 3363,
15
        "lastUpdatingUserId": 3363,
16
        "deletedAt": "2021-03-08T18:17:16.719Z",
17
        "deletingUserId": 3363,
18
        "rules": [
19
          {
20
            "path": "$.Patient.Demographics.FirstName",
21
            "values": [
22
              "string"
23
            ],
24
            "allowList": true
25
          }
26
        ],
27
        "filterLinks": [
28
          {
29
            "id": "b65f7210-1c60-40fd-975e-1baaf5011277",
30
            "createdAt": "2021-03-08T18:10:37.571Z",
31
            "updatedAt": "2021-03-08T18:10:37.571Z",
32
            "version": "1.0.0",
33
            "organizationId": 123,
34
            "creatingUserId": 3363,
35
            "lastUpdatingUserId": 3363,
36
            "dataModel": "PatientAdmin",
37
            "eventType": "NewPatient",
38
            "deletedAt": "2021-03-08T18:10:37.571Z",
39
            "deletingUserId": 3363,
40
            "destinationId": "74827916-39fa-4b76-bcf8-969aad3fca88",
41
            "sourceId": "98d3cc95-66d8-4d46-b05c-77dcf231aa4b",
42
            "filterSettingsId": "09a85196-2760-4296-b874-59d0cdbb7bc4"
43
          }
44
        ],
45
        "pathType": "jsonpath"
46
      }
47
    ]
48
  }
49
}
  • payload
    object
    • filters
      Array of object

      Contains an array of filter instances.

      • id
        string

        Displays the unique ID of the filter.

        Format: uuid
      • filterVersion
        integer

        Displays the numeric version of the filter. A new filter version is created whenever the filter is modified.

      • createdAt
        string

        Displays a timestamp of when the filter was initially created.

      • updatedAt
        string

        Displays a timestamp of when the filter was last updated.

      • version
        string

        Displays the API schema version used for this filter instance.

      • name
        string

        Displays the filter's human-readable name.

      • organizationId
        integer

        Identifies the Redox organization that the filter belongs to.

      • environmentId
        string

        Identifies the environment that the filter belongs to.

      • action
        string

        Indicates the action to be performed when the filter rules are met.

        Possible Values: send, block-all
      • creatingUserId
        integer

        Displays the unique ID of the user that created the filter.

      • lastUpdatingUserId
        integer

        Displays the unique ID of the user that most recently updated the filter.

      • deletedAt
        string

        Displays a timestamp of when the filter was deleted. If the filter hasn't been deleted, this field is populated with a null value.

      • deletingUserId
        integer

        Displays the unique ID of the user that deleted the filter. If the filter hasn't been deleted, this field is populated with a null value.

      • rules
        Array of object

        Contains a list of rules that determine when the filter is applied to a message. A filter is only applied if ALL rules are met.

        • path
          string

          Specifies the path to the field(s) that should be evaluated when the filter is applied. This should be a jsonpath value.

        • values
          Array of string

          Contains an array of string values that are matched against the path value when the rule is evaluated.

        • allowList
          boolean

          Indicates whether the rule is an allow-list (matches when the value at the specified path is in the values array) or a deny-list (matches when the value at the specified path is NOT in the values array). Defaults to true (allow-list).

      • Contains an array of filter links, which indicate which connection(s), data models, and event types the filter is used for. Usually filters are only used in one place, so this array will usually have just one entry.

        • id
          string

          Displays the unique ID of this filter link.

          Format: uuid
        • createdAt
          string

          Displays a timestamp of when the filter link was initially created.

        • updatedAt
          string

          Displays a timestamp of when the filter link was last updated.

        • version
          string

          Displays the API schema version used for this filter link.

        • organizationId
          integer

          Identifies the Redox organization that the filter link belongs to.

        • creatingUserId
          integer

          Displays the unique ID of the user that initially created the filter link.

        • lastUpdatingUserId
          integer

          Displays the unique ID of the user that last updated the filter link.

        • dataModel
          string

          Displays the data model that the filter link is applied to.

        • eventType
          string

          Displays the specific event type that the filter link is applied to, if any.

        • deletedAt
          string

          Displays a timestamp of when the filter link was deleted. If the filter link hasn't been deleted, this field is populated with a null value.

        • deletingUserId
          integer

          Displays the unique ID of the user that deleted the filter link. If the filter link hasn't been deleted, this field is populated with a null value.

        • destinationId
          string

          Displays the unique ID of the destination that the filter link is applied to.

          Format: uuid
        • sourceId
          string

          Displays the unique ID of the source that the filter link is applied to.

          Format: uuid
        • filterSettingsId
          string

          Displays the unique ID of the filter that is being applied by the filter link.

          Format: uuid
      • pathType
        string

        Specifies the format of the field paths defined for this filter's rules. Both FHIR and data model filters use the jsonpath path type.

        Value: jsonpath