v1
latestOpenAPI 3.1.02026-07-2342137210.8 KBSearch Analyses
Returns a paginated list of your Beam Analyses. Supports filtering by status, readiness_status, industry, interval, label, and date range.
Query parameters
Comma-separated list used to filter Beam analyses by their status.
- active — returns analyses that are currently in use.
- deleted — returns analyses that have been deleted.
Comma-separated list used to filter Beam analyses by their readiness status.
- pending — processing in progress.
- ready — processing completed successfully.
- failed — processing failed.
- stale — results are outdated and need refreshing.
An Analysis Group ID. Analyses that belong to this group will be returned.
Filter analyses by their demand data interval.
- day — returns analyses with daily demand data.
- week — returns analyses with weekly demand data.
Comma-separated list used to filter Beam analyses by industry. Only analyses matching one of the specified industries are returned.
- accommodation — Accommodation providers, travel tech, and OTAs
- cpg — Consumer packaged goods companies
- tourism — Leisure, travel, and tourism businesses (e.g. Expedia, DMOs, travel platforms)
- marketing — Advertising and marketing services
- parking — Parking facility operators
- restaurants — Food and beverage businesses including restaurant groups
- retail — Non-food retail and retail tech
- transportation — On-demand transport and delivery
- other — All other industries
Comma-separated list of External IDs.
Comma-separated list of labels.
Comma-separated list of Saved Location IDs.
Comma-separated list used to sort Beam analyses. Prefix a field name with - to reverse the default direction.
- name: sort alphabetically A–Z
- -name: sort alphabetically Z–A
- created: oldest first (ascending)
- -created: newest first (descending)
- updated: oldest first (ascending)
- -updated: newest first (descending)
Maximum number of results to return per page.
Zero-based index of the first result to return.
Return analyses last updated after this date (exclusive).
Return analyses last updated on or after this date (inclusive).
Return analyses last updated before this date (exclusive).
Return analyses last updated on or before this date (inclusive).
Filter analyses by name using a text search. Supports partial and prefix matching (e.g., downt will match Downtown Store).
Response
Successful Response