---
updatedAt: 2026-08-14T17:21:29.000Z
agentTools:
  projectIndex: https://docs.wistia.com/llms.txt
---

# List Review Bundles

Lists review bundles belonging to an account. This endpoint can also be used to
do a batch fetch based off of the hashed id, or to find the bundles that include
a given media or any media from a folder.


## Requires api token with one of the following permissions
```
Read all folder and media data
```

Tokens with the "Act with a team member's permissions" permission
(`all:delegate_to_contact_permissions` scope) can also be used. Requests
made with such a token are authorized using the permissions of the
contact assigned to the token.

An [expiring access token](https://docs.wistia.com/reference/post_expiring-token)
created with the `all:delegate_to_contact_permissions` scope and an
authorization naming a review bundle (any permission) can also be used; it
lists the review bundles the token names.



# OpenAPI definition

````json
{
  "openapi": "3.1.1",
  "info": {
    "title": "Data API",
    "description": "Wistia Data API",
    "version": "2026.09.0"
  },
  "servers": [
    {
      "url": "https://api.wistia.com/modern"
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Review Bundles"
    }
  ],
  "paths": {
    "/review_bundles": {
      "get": {
        "summary": "List Review Bundles",
        "x-speakeasy-group": "reviewBundles",
        "x-speakeasy-name-override": "list",
        "description": "Lists review bundles belonging to an account. This endpoint can also be used to\ndo a batch fetch based off of the hashed id, or to find the bundles that include\na given media or any media from a folder.\n\n\n## Requires api token with one of the following permissions\n```\nRead all folder and media data\n```\n\nTokens with the \"Act with a team member's permissions\" permission\n(`all:delegate_to_contact_permissions` scope) can also be used. Requests\nmade with such a token are authorized using the permissions of the\ncontact assigned to the token.\n\nAn [expiring access token](https://docs.wistia.com/reference/post_expiring-token)\ncreated with the `all:delegate_to_contact_permissions` scope and an\nauthorization naming a review bundle (any permission) can also be used; it\nlists the review bundles the token names.\n\n",
        "tags": [
          "Review Bundles"
        ],
        "parameters": [
          {
            "name": "hashed_ids[]",
            "in": "query",
            "description": "Restrict the results to the review bundles with these hashed IDs.",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "name",
            "in": "query",
            "description": "Restrict the results to review bundles whose name contains this value (case-insensitive).",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "media_hashed_id",
            "in": "query",
            "description": "Restrict the results to review bundles that include the media with this hashed ID.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "folder_hashed_id",
            "in": "query",
            "description": "Restrict the results to review bundles that include any media from the folder with this hashed ID.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort_by",
            "in": "query",
            "description": "Field to order by. The default is id.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "id",
                "name",
                "created",
                "updated"
              ]
            }
          },
          {
            "name": "sort_direction",
            "in": "query",
            "description": "Direction to order by. (0 = desc, 1 = asc; default is 1)",
            "required": false,
            "schema": {
              "type": "integer",
              "enum": [
                0,
                1
              ]
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "The page number to retrieve. This cannot be combined with `cursor`,\npagination.\n",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "per_page",
            "in": "query",
            "description": "The number of medias per page. Use this for both offset pagination and cursor pagination.",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "If `cursor[enabled]` is set to 1 then cursor pagination is enabled and the\nfirst set of records are fetched up to the `per_page`. Cursor\npagination will also be turned on if `cursor[before]` or `cursor[after]`\nare set. Records returned will have a `cursor` property set which can be used to fetch more records in the same `sort_by` ordering.\nThe cursor value of the last record can be used to fetch records after the current result set and\nthe cursor of the first record can be used to fetch records before the result set.\n\nNOTE: a cursor value is only valid if the `sort_by` value hasn't changed from the\nlast fetch. For example, you cannot fetch using `sort_by` id and then pass that\ncursor value to a `sort_by` name.\n",
            "required": false,
            "schema": {
              "unevaluatedProperties": false,
              "type": "object",
              "properties": {
                "enabled": {
                  "description": "If `cursor[enabled]` is set to 1, the first result set will be fetched with cursor pagination enabled. This\nvalues is ignored if `cursor[before]` or `cursor[after]` are set.\n",
                  "type": "integer",
                  "enum": [
                    0,
                    1
                  ]
                },
                "before": {
                  "description": "If `cursor[before]` is set then cursor pagination is enabled and all records\nbefore the cursor up to the `per_page` are returned. This feature is useful for\nfetching \"new records\", for example, in a \"pull to refersh\" feature when showing records in a descending\norder.\n",
                  "type": "string"
                },
                "after": {
                  "description": "If `cursor[after]` is set then cursor pagination is enabled and all records\nafter the cursor up to the `per_page` are returned.\n",
                  "type": "string"
                }
              }
            },
            "style": "deepObject"
          },
          {
            "name": "X-Wistia-API-Version",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "default": "2026-09"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Review Bundles retrieval successful",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "unevaluatedProperties": false,
                    "properties": {
                      "hashed_id": {
                        "description": "A unique alphanumeric identifier for this review bundle.",
                        "type": "string"
                      },
                      "name": {
                        "description": "The bundle display name.",
                        "type": "string",
                        "examples": [
                          "My Review Bundle Title"
                        ]
                      },
                      "url": {
                        "description": "The URL of the bundle.",
                        "type": "string",
                        "examples": [
                          "https://[your-domain].wistia.com/reviews/bundles/1234567890"
                        ]
                      },
                      "allow_downloads": {
                        "description": "Whether the videos in the bundle can be downloaded.",
                        "type": "boolean"
                      },
                      "cursor": {
                        "description": "A cursor for stable pagination based on current `sort_by` order. You can pass this to `cursor[before]` or `cursor[after]` as a parameter to fetch the records before or after this record in the same sort order. This is only populated if records were fetched with `cursor[enabled]`, or `cursor[before]` or `cursor[after]`.",
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "unevaluatedProperties": false,
                  "type": "object",
                  "properties": {
                    "error": {
                      "description": "Error message detailing the reason for the bad request.",
                      "type": "string",
                      "examples": [
                        "Bad request"
                      ]
                    },
                    "errors": {
                      "description": "Array of error messages detailing the reasons for the bad request.",
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized, invalid or missing token",
            "content": {
              "application/json": {
                "schema": {
                  "unevaluatedProperties": false,
                  "type": "object",
                  "properties": {
                    "code": {
                      "description": "A machine-readable identifier for the specific authorization failure.",
                      "type": "string",
                      "enum": [
                        "unauthorized_credentials",
                        "account_inactive",
                        "unauthorized_scope",
                        "unauthorized_params"
                      ]
                    },
                    "error": {
                      "type": "string",
                      "examples": [
                        "Invalid credentials."
                      ]
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "unevaluatedProperties": false,
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "examples": [
                        "Internal server error"
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "x-readme": {
          "code-samples": [
            {
              "name": "Typescript (SDK)",
              "language": "javascript",
              "code": "import { Wistia } from \"@wistia/wistia-api-client\";\n\nconst wistia = new Wistia({\n  bearerAuth: process.env[\"WISTIA_BEARER_AUTH\"] ?? \"\",\n});\n\nasync function run() {\n  const result = await wistia.reviewBundles.list();\n\n  console.log(result);\n}\n\nrun();"
            }
          ]
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  },
  "x-readme": {
    "samples-languages": [
      "javascript",
      "shell",
      "node",
      "python",
      "ruby"
    ]
  }
}
````