---
updatedAt: 2026-09-01T20:42:06.000Z
---

# Navigate segment category tree

Returns one level of the segment category tree at a time for lazy loading. Without parent_key parameter: returns top-level categories (where parent_key is NULL). With parent_key=<key>: returns child categories of the specified parent. Each category includes a subcategories_url for navigating to its children.

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Reference Resources",
    "version": "2.0.0",
    "description": "Buzz API v2"
  },
  "paths": {
    "/segment-categories/tree": {
      "get": {
        "operationId": "segment_categories_tree_list",
        "description": "Returns one level of the segment category tree at a time for lazy loading. Without parent_key parameter: returns top-level categories (where parent_key is NULL). With parent_key=<key>: returns child categories of the specified parent. Each category includes a subcategories_url for navigating to its children.",
        "summary": "Navigate segment category tree",
        "parameters": [
          {
            "in": "query",
            "name": "account_id",
            "schema": {
              "type": "number"
            }
          },
          {
            "in": "query",
            "name": "account_id__in",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "description": "Multiple values may be separated by commas.",
            "explode": false,
            "style": "form"
          },
          {
            "in": "query",
            "name": "account_id__not",
            "schema": {
              "type": "number"
            }
          },
          {
            "in": "query",
            "name": "account_id__not_in",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "description": "Multiple values may be separated by commas.",
            "explode": false,
            "style": "form"
          },
          {
            "in": "query",
            "name": "active",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "in": "query",
            "name": "advertiser_id",
            "schema": {
              "type": "number"
            }
          },
          {
            "in": "query",
            "name": "advertiser_id__equals_or_null",
            "schema": {
              "type": "number"
            }
          },
          {
            "in": "query",
            "name": "advertiser_id__gt",
            "schema": {
              "type": "number"
            }
          },
          {
            "in": "query",
            "name": "advertiser_id__gte",
            "schema": {
              "type": "number"
            }
          },
          {
            "in": "query",
            "name": "advertiser_id__in",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "description": "Multiple values may be separated by commas.",
            "explode": false,
            "style": "form"
          },
          {
            "in": "query",
            "name": "advertiser_id__isempty",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "in": "query",
            "name": "advertiser_id__lt",
            "schema": {
              "type": "number"
            }
          },
          {
            "in": "query",
            "name": "advertiser_id__lte",
            "schema": {
              "type": "number"
            }
          },
          {
            "in": "query",
            "name": "advertiser_id__not",
            "schema": {
              "type": "number"
            }
          },
          {
            "in": "query",
            "name": "advertiser_id__not_in",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "description": "Multiple values may be separated by commas.",
            "explode": false,
            "style": "form"
          },
          {
            "in": "query",
            "name": "alternative_id",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "alternative_id__contains",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "alternative_id__in",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "Multiple values may be separated by commas.",
            "explode": false,
            "style": "form"
          },
          {
            "in": "query",
            "name": "alternative_id__isempty",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "in": "query",
            "name": "alternative_id__not",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "alternative_id__not_contains",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "alternative_id__not_in",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "Multiple values may be separated by commas.",
            "explode": false,
            "style": "form"
          },
          {
            "in": "query",
            "name": "alternative_id__not_startswith",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "alternative_id__startswith",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "create_date",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "in": "query",
            "name": "create_date__gt",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "in": "query",
            "name": "create_date__gte",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "in": "query",
            "name": "create_date__isempty",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "in": "query",
            "name": "create_date__lt",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "in": "query",
            "name": "create_date__lte",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "in": "query",
            "name": "create_date__range",
            "schema": {
              "type": "string",
              "nullable": true,
              "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
              "example": "2025-09-29 00:00:00",
              "enum": [
                "future",
                "last_14_complete_days",
                "last_14_days",
                "last_24_hours",
                "last_30_complete_days",
                "last_30_days",
                "last_365_complete_days",
                "last_365_days",
                "last_7_complete_days",
                "last_7_days",
                "last_90_complete_days",
                "last_90_days",
                "last_month",
                "last_quarter",
                "last_week",
                "last_year",
                "past",
                "this_month",
                "this_quarter",
                "this_week",
                "this_year",
                "today",
                "until_past_24_hours",
                "yesterday"
              ]
            },
            "description": "The date and time the object was first created\n\n* `today` - From last midnight to next midnight\n* `yesterday` - The last complete calendar day\n* `last_24_hours` - The last 24 hours (as opposed to today, which is from midnight to midnight)\n* `this_week` - From midnight the previous Sunday until midnight the coming Sunday\n* `last_week` - The last complete calendar week\n* `this_year` - From the January 1 to December 31 this year\n* `last_year` - The last complete calendar year\n* `this_month` - From the first day to the last day of the current month\n* `last_month` - The last complete calendar month\n* `this_quarter` - From the first day to the last day of the current quarter\n* `last_quarter` - The last complete calendar quarter\n* `last_7_days` - From midnight 7 days ago to the present\n* `last_7_complete_days` - From midnight 7 days ago to last midnight\n* `last_14_days` - From midnight 14 days ago to the present\n* `last_14_complete_days` - From midnight 14 days ago to last midnight\n* `last_30_days` - From midnight 30 days ago to the present\n* `last_30_complete_days` - From midnight 30 days ago to last midnight\n* `last_90_days` - From midnight 90 days ago to the present\n* `last_90_complete_days` - From midnight 90 days ago to last midnight\n* `last_365_days` - From midnight 365 days ago to the present\n* `last_365_complete_days` - From midnight 365 days ago to last midnight\n* `past` - Any date in the past. Useful for Buzz queries against end_date and similar fields\n* `future` - Any date in the future. Useful for Buzz queries against end_date and similar fields\n* `until_past_24_hours` - From the very first date in the past and up until past 24 hours"
          },
          {
            "in": "query",
            "name": "id",
            "schema": {
              "type": "number"
            }
          },
          {
            "in": "query",
            "name": "id__gt",
            "schema": {
              "type": "number"
            }
          },
          {
            "in": "query",
            "name": "id__gte",
            "schema": {
              "type": "number"
            }
          },
          {
            "in": "query",
            "name": "id__in",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "description": "Multiple values may be separated by commas.",
            "explode": false,
            "style": "form"
          },
          {
            "in": "query",
            "name": "id__lt",
            "schema": {
              "type": "number"
            }
          },
          {
            "in": "query",
            "name": "id__lte",
            "schema": {
              "type": "number"
            }
          },
          {
            "in": "query",
            "name": "id__not",
            "schema": {
              "type": "number"
            }
          },
          {
            "in": "query",
            "name": "id__not_in",
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "description": "Multiple values may be separated by commas.",
            "explode": false,
            "style": "form"
          },
          {
            "in": "query",
            "name": "key",
            "schema": {
              "type": "string"
            },
            "description": "Only return records whose key exactly matches this value."
          },
          {
            "in": "query",
            "name": "key__in",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "Only return records whose key matches one of these values. Multiple values may be separated by commas.",
            "explode": false,
            "style": "form"
          },
          {
            "in": "query",
            "name": "key__isempty",
            "schema": {
              "type": "boolean"
            },
            "description": "When true, only return records with an empty or missing key. When false, exclude them."
          },
          {
            "in": "query",
            "name": "key__not",
            "schema": {
              "type": "string"
            },
            "description": "Exclude records whose key exactly matches this value."
          },
          {
            "in": "query",
            "name": "key__not_in",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "Exclude records whose key matches one of these values. Multiple values may be separated by commas.",
            "explode": false,
            "style": "form"
          },
          {
            "in": "query",
            "name": "name",
            "schema": {
              "type": "string"
            },
            "description": "Only return records whose name exactly matches this value."
          },
          {
            "in": "query",
            "name": "name__contains",
            "schema": {
              "type": "string"
            },
            "description": "Only return records whose name contains this value (case-insensitive)."
          },
          {
            "in": "query",
            "name": "name__in",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "Only return records whose name matches one of these values. Multiple values may be separated by commas.",
            "explode": false,
            "style": "form"
          },
          {
            "in": "query",
            "name": "name__isempty",
            "schema": {
              "type": "boolean"
            },
            "description": "When true, only return records with an empty or missing name. When false, exclude them."
          },
          {
            "in": "query",
            "name": "name__not",
            "schema": {
              "type": "string"
            },
            "description": "Exclude records whose name exactly matches this value."
          },
          {
            "in": "query",
            "name": "name__not_contains",
            "schema": {
              "type": "string"
            },
            "description": "Exclude records whose name contains this value (case-insensitive)."
          },
          {
            "in": "query",
            "name": "name__not_in",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "Exclude records whose name matches one of these values. Multiple values may be separated by commas.",
            "explode": false,
            "style": "form"
          },
          {
            "in": "query",
            "name": "notes__isempty",
            "schema": {
              "type": "boolean"
            },
            "description": "When true, only return segment categories with an empty or missing note text. When false, exclude them."
          },
          {
            "name": "order",
            "required": false,
            "in": "query",
            "description": "Which field to use when ordering the results.",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "parent_key",
            "schema": {
              "type": "string"
            },
            "description": "Only return segment categories whose parent category key exactly matches this value."
          },
          {
            "in": "query",
            "name": "parent_key__in",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "Only return segment categories whose parent category key matches one of these values. Multiple values may be separated by commas.",
            "explode": false,
            "style": "form"
          },
          {
            "in": "query",
            "name": "parent_key__isempty",
            "schema": {
              "type": "boolean"
            },
            "description": "When true, only return segment categories with an empty or missing parent category key. When false, exclude them."
          },
          {
            "in": "query",
            "name": "parent_key__not",
            "schema": {
              "type": "string"
            },
            "description": "Exclude segment categories whose parent category key exactly matches this value."
          },
          {
            "in": "query",
            "name": "parent_key__not_in",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "Exclude segment categories whose parent category key matches one of these values. Multiple values may be separated by commas.",
            "explode": false,
            "style": "form"
          },
          {
            "in": "query",
            "name": "update_date",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "in": "query",
            "name": "update_date__gt",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "in": "query",
            "name": "update_date__gte",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "in": "query",
            "name": "update_date__isempty",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "in": "query",
            "name": "update_date__lt",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "in": "query",
            "name": "update_date__lte",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "in": "query",
            "name": "update_date__range",
            "schema": {
              "type": "string",
              "nullable": true,
              "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
              "example": "2025-09-29 00:00:00",
              "enum": [
                "future",
                "last_14_complete_days",
                "last_14_days",
                "last_24_hours",
                "last_30_complete_days",
                "last_30_days",
                "last_365_complete_days",
                "last_365_days",
                "last_7_complete_days",
                "last_7_days",
                "last_90_complete_days",
                "last_90_days",
                "last_month",
                "last_quarter",
                "last_week",
                "last_year",
                "past",
                "this_month",
                "this_quarter",
                "this_week",
                "this_year",
                "today",
                "until_past_24_hours",
                "yesterday"
              ]
            },
            "description": "The date and time the object was last updated\n\n* `today` - From last midnight to next midnight\n* `yesterday` - The last complete calendar day\n* `last_24_hours` - The last 24 hours (as opposed to today, which is from midnight to midnight)\n* `this_week` - From midnight the previous Sunday until midnight the coming Sunday\n* `last_week` - The last complete calendar week\n* `this_year` - From the January 1 to December 31 this year\n* `last_year` - The last complete calendar year\n* `this_month` - From the first day to the last day of the current month\n* `last_month` - The last complete calendar month\n* `this_quarter` - From the first day to the last day of the current quarter\n* `last_quarter` - The last complete calendar quarter\n* `last_7_days` - From midnight 7 days ago to the present\n* `last_7_complete_days` - From midnight 7 days ago to last midnight\n* `last_14_days` - From midnight 14 days ago to the present\n* `last_14_complete_days` - From midnight 14 days ago to last midnight\n* `last_30_days` - From midnight 30 days ago to the present\n* `last_30_complete_days` - From midnight 30 days ago to last midnight\n* `last_90_days` - From midnight 90 days ago to the present\n* `last_90_complete_days` - From midnight 90 days ago to last midnight\n* `last_365_days` - From midnight 365 days ago to the present\n* `last_365_complete_days` - From midnight 365 days ago to last midnight\n* `past` - Any date in the past. Useful for Buzz queries against end_date and similar fields\n* `future` - Any date in the future. Useful for Buzz queries against end_date and similar fields\n* `until_past_24_hours` - From the very first date in the past and up until past 24 hours"
          }
        ],
        "tags": [
          "Segments"
        ],
        "security": [
          {
            "nestSessionAuth": []
          },
          {
            "nestBasicAuth": []
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedSegmentCategoryTreeList"
                }
              }
            },
            "description": "Segment category tree level retrieved successfully."
          },
          "400": {
            "description": "Invalid filter or query parameters."
          },
          "401": {
            "description": "Authentication credentials were not provided."
          },
          "403": {
            "description": "Permission denied."
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "PaginatedSegmentCategoryTreeList": {
        "type": "object",
        "required": [
          "count",
          "results"
        ],
        "properties": {
          "count": {
            "type": "integer",
            "example": 123
          },
          "next": {
            "type": "string",
            "nullable": true,
            "format": "uri",
            "example": "http://api.example.org/accounts/?page=4"
          },
          "previous": {
            "type": "string",
            "nullable": true,
            "format": "uri",
            "example": "http://api.example.org/accounts/?page=2"
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SegmentCategoryTree"
            }
          }
        }
      },
      "SegmentCategoryTree": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "readOnly": true,
            "description": "Unique ID of the segment category"
          },
          "account_id": {
            "type": "integer",
            "readOnly": true,
            "description": "The account that owns the segment category."
          },
          "advertiser_id": {
            "type": "integer",
            "nullable": true,
            "readOnly": true,
            "description": "The advertiser that owns the segment category, if any."
          },
          "key": {
            "type": "string",
            "nullable": true,
            "description": "Alphanumeric key for the segment or category, in the format {Data Provider}-{Segment / Category ID}.",
            "maxLength": 30
          },
          "name": {
            "type": "string",
            "description": "Name of the segment category",
            "maxLength": 191
          },
          "active": {
            "type": "boolean",
            "default": true,
            "description": "Whether the segment category is active."
          },
          "create_date": {
            "type": "string",
            "nullable": true,
            "description": "The date and time the object was first created",
            "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
            "example": "2025-09-29 00:00:00"
          },
          "update_date": {
            "type": "string",
            "readOnly": true,
            "nullable": true,
            "description": "The date and time the object was last updated",
            "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
            "example": "2025-09-29 00:00:00"
          },
          "alternative_id": {
            "type": "string",
            "nullable": true,
            "description": "An ID that may be used for any reporting or administrative purpose. Limited to 191 characters.",
            "maxLength": 200
          },
          "notes": {
            "type": "string",
            "nullable": true,
            "description": "Free-form notes of up to 255 characters.",
            "maxLength": 255
          },
          "subcategories_url": {
            "type": "string",
            "readOnly": true,
            "description": "URL to fetch child categories of this category for lazy loading."
          }
        },
        "required": [
          "account_id",
          "advertiser_id",
          "id",
          "name",
          "subcategories_url",
          "update_date"
        ]
      }
    },
    "securitySchemes": {
      "nestBasicAuth": {
        "type": "http",
        "scheme": "basic",
        "description": "Form-based Basic Authentication"
      },
      "nestSessionAuth": {
        "type": "http",
        "scheme": "basic",
        "description": "Form-based Basic Authentication"
      }
    }
  },
  "x-explorer-enabled": false,
  "x-samples-languages": [
    "curl",
    "node",
    "ruby",
    "javascript",
    "python",
    "php",
    "java"
  ],
  "servers": [
    {
      "url": "https://{buzz_key}.api.beeswax.com/rest/v2",
      "variables": {
        "buzz_key": {
          "default": "stingersbx",
          "description": "Unique customer ID assigned by the Beeswax"
        }
      }
    }
  ],
  "x-readme": {
    "apply-endpoint-order": true,
    "apply-tag-changes": true
  }
}
```