curl --request POST \
  --url https://api.kit.com/v4/subscribers/filter \
  --header 'Content-Type: application/json' \
  --header 'X-Kit-Api-Key: <api-key>' \
  --data '
{
  "all": [
    {
      "type": "opens",
      "count_greater_than": 5,
      "after": "2024-01-01",
      "before": "2024-12-31"
    },
    {
      "type": "clicks",
      "count_greater_than": 2,
      "after": "2024-01-01",
      "before": "2024-12-31",
      "any": [
        {
          "type": "urls",
          "urls": [
            "kit.com",
            "amazon.com"
          ],
          "matching": "contains"
        },
        {
          "type": "broadcasts",
          "ids": [
            1,
            2,
            3
          ]
        }
      ]
    },
    {
      "type": "tags",
      "any": [
        {
          "type": "ids",
          "matching": [
            123,
            456
          ]
        }
      ]
    },
    {
      "type": "attribution",
      "any": [
        {
          "type": "forms",
          "ids": [
            789,
            1001
          ]
        }
      ]
    },
    {
      "type": "custom_field",
      "subscriber_custom_field_id": 42,
      "value": "premium",
      "comparison": "is"
    }
  ]
}
'

{
  "subscribers": [
    {
      "id": "456",
      "first_name": "Jane",
      "email_address": "jane@example.com",
      "created_at": "2024-12-01T15:45:00Z",
      "tag_names": [
        "newsletter",
        "engaged"
      ],
      "tag_ids": [
        "123",
        "456"
      ]
    },
    {
      "id": "789",
      "first_name": null,
      "email_address": "anonymous@example.com",
      "created_at": "2024-11-15T10:00:00Z",
      "tag_names": [],
      "tag_ids": []
    }
  ],
  "pagination": {
    "has_previous_page": false,
    "has_next_page": true,
    "start_cursor": "WzQ1Nl0=",
    "end_cursor": "Wzc4OV0=",
    "per_page": 10,
    "total_count": 42
  }
}