SegmentSeriesRequestDTOResourceObject

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/SegmentSeriesRequestDTOResourceObject",
  "title": "SegmentSeriesRequestDTOResourceObject",
  "type": "object",
  "properties": {
    "type": {
      "$ref": "#/components/schemas/SegmentSeriesReportEnum"
    },
    "attributes": {
      "type": "object",
      "properties": {
        "statistics": {
          "description": "List of statistics to query for.",
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "members_added",
              "members_removed",
              "net_members_changed",
              "total_members"
            ],
            "description": "Defined segment reporting metric"
          },
          "example": [
            "total_members",
            "net_members_changed"
          ]
        },
        "timeframe": {
          "description": "The time frame to pull data from (Max length: 1 year). Data is unavailable before June 1st, 2023. Please use a time frame after this date. See [available time frames](https://developers.klaviyo.com/en/reference/reporting_api_overview#available-time-frames).",
          "oneOf": [
            {
              "$ref": "#/components/schemas/Timeframe"
            },
            {
              "$ref": "#/components/schemas/CustomTimeframe"
            }
          ]
        },
        "interval": {
          "description": "The interval used to aggregate data within the series request.\nIf hourly is used, the timeframe cannot be longer than 7 days.\nIf daily is used, the timeframe cannot be longer than 60 days.\nIf monthly is used, the timeframe cannot be longer than 52 weeks.",
          "type": "string",
          "example": "weekly",
          "enum": [
            "daily",
            "hourly",
            "monthly",
            "weekly"
          ]
        },
        "filter": {
          "description": "API filter string used to filter the query.\nAllowed filters are segment_id.\nAllowed operators are equals, any.\nOnly one filter can be used per attribute.\nMax of 100 messages per ANY filter.",
          "type": "string",
          "example": "any(segment_id,[\"xyz123\",\"ghi456\"])",
          "nullable": true
        }
      },
      "required": [
        "statistics",
        "timeframe",
        "interval"
      ]
    }
  },
  "required": [
    "type",
    "attributes"
  ]
}