How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Bem Views API

Views are tabular projections over the `transformations` your functionsproduce — a saved query that turns raw extracted JSON into afilterable, paginatable, aggregatable table.## AnatomyA view declares:- One or more **functions** to read from (by `functionID` or `functionName`).- A list of **columns**, each pinned to a `valueSchemaPath` (a JSON Pointer into the function's output schema).- Optional **filters** (string equality, numeric comparators, null-checks) and **aggregations** (`count`, `count_distinct`, `sum`, `average`, `min`, `max`).Views are versioned: every update produces a new version, and theprevious version remains immutable and addressable. Function typesthat produce transformations with an output schema — `extract`,`transform`, `analyze`, `join` — are all queryable through views;`extract` works uniformly across vision and OCR inputs.## Reading data- **`POST /v3/views/table-data`** — paginated rows of column values. Each row reports the underlying event's `eventID` (the externally-stable KSUID used everywhere else in V3) plus the projected column values.- **`POST /v3/views/aggregation-data`** — group-by-able aggregate values across the same query surface.Both endpoints take a `timeWindow` to bound the transformation setand require at least one `function` to read from.

Bem Views API is one of 22 APIs that Bem publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Views. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 7 operations across 4 paths, and defines 19 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against 2 base URLs: https://api.bem.ai, https://api.eu1.bem.ai.

7 operations 4 paths 19 schemas 1 DELETE2 GET3 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.bem.ai
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Bem Views API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-key (API Key). By default, every request must be authenticated.

  • API Key — Authenticate using API Key in request header

Paths & Operations 7

Across 4 paths, the API surfaces 7 operations — 1 DELETE, 2 GET, 3 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Views 7

Views are tabular projections over the transformations your functions produce — a saved query that turns raw extracted JSON into a filterable, paginatable, aggregatable table. Ana…

GET
/v3/views
List Views
v3-list-views 8 params → 200
POST
/v3/views
Create a View
v3-create-view body → 200
POST
/v3/views/aggregation-data
Generate View Aggregation Data
v3-generate-view-aggregation-data body → 200400
POST
/v3/views/table-data
Generate View Table Data
v3-generate-view-table-data body → 200400
DELETE
/v3/views/{view_id}
Delete a View
v3-delete-view 1 param → 200
GET
/v3/views/{view_id}
Get a View
v3-get-view 1 param → 200
PUT
/v3/views/{view_id}
Update a View
v3-update-view 1 param body → 200

Schemas 19

The contract defines 19 schemas that model the data the API accepts and returns. The most detailed are ViewTableDataRequest (9 properties), View (8 properties), ViewAggregationDataRequest (7 properties), ViewCreateRequest (6 properties). Each schema is shown below with its type and property counts.

ViewFilter
object
A filter to apply to a view column
4 properties 2 required
ViewTableDataRequest
object
9 properties 6 required
ListViewsResponse
object
Response containing a list of views
2 properties 2 required
ViewAggregationDataRequest
object
7 properties 6 required
TimeWindow
object
Time window for filtering transformations in a view
2 properties 2 required
ViewAggregationFunction
string
Aggregation function to apply to a view column
ViewAggregation
object
An aggregation definition for a view
5 properties 2 required
View
object
A view is a table visualization of transformations that allows customers to have insight into their transformations
8 properties 7 required
ViewAggregationDataResponse
object
Response containing aggregation data for a view
1 property 1 required
ViewColumn
object
A column definition in a view
3 properties 3 required
FunctionIdentifier
object
2 properties
ViewTableDataResponse
object
Response containing paginated view table data
2 properties 2 required
ViewTableDataResponseRow
object
A single row in the view table data response
2 properties 2 required
ViewAggregationDataResponseGroup
object
A single group result in an aggregation response
2 properties 2 required
ViewAggregationDataResponseAggregation
object
Aggregation result for a single aggregation definition
2 properties 2 required
ViewTableDataResponseColumnEntry
object
A single column entry in a view table data row
2 properties 2 required
ViewFilterType
string
Type of filter to apply to a view column
HTTPError
object
Standard HTTP error response
3 properties 1 required
ViewCreateRequest
object
Request to create a new view or update an existing view
6 properties 5 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

bem-views-api-openapi.yml Raw ↑

Other APIs Bem publishes across the network.

Bem Buckets API
Bem Calls API
Bem Collections API
Bem Connectors API
Bem Entity Bulk Seed API
Bem Entity Curation API
Bem Entity Synonyms API
Bem Entity Type Reviewers API
Bem Entity Types API
Bem Errors API
Bem Feedback API
Bem File System API
Where this information came from

This is an independent, third-party profile of Bem Views API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.