# Bem Collections API

**Canonical:** https://apis.io/apis/bem/bem-collections-api/  
**Provider:** Bem — https://apis.io/providers/bem/  
**Base URL:** https://api.bem.ai  
**Documentation:** https://docs.bem.ai

Bem Collections API is one of 22 APIs that [Bem](https://apis.io/providers/bem/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Collection. The published artifact set on APIs.io includes an OpenAPI specification.

Collections are named groups of embedded items used by Enrich functions for semantic search. Each collection is referenced by a `collectionName`, which supports dot notation for hierarchical paths (e.g. `customers.premium.vip`). Names must contain only letters, digits, underscores, and dots, and each segment must start with a letter or underscore. ## Items Items carry either a string or a JSON object in their `data` field. When items are added or updated, their `data` is embedded asynchronously — `POST /v3/collections/items` and `PUT /v3/collections/items` return immediately with a `pending` status and an `eventID` that can be correlated with webhook notifications once processing completes. ## Listing and hierarchy Use `GET /v3/collections` with `parentCollectionName` to list collections under a path, or `collectionNameSearch` for a case-insensitive substring match. `GET /v3/collections/items` retrieves a specific collection's items; pass `includeSubcollections=true` to fold in items from all descendant collections. ## Token counting Use `POST /v3/collections/token-count` to check whether texts fit within the embedding model's 8,192-token-per-text limit before submitting them for embedding.

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/bem/refs/heads/main/openapi/bem-collections-api-openapi.yml

## Other Bem APIs (12)

- [Bem Buckets API](https://apis.io/apis/bem/bem-buckets-api/)
- [Bem Calls API](https://apis.io/apis/bem/bem-calls-api/)
- [Bem Connectors API](https://apis.io/apis/bem/bem-connectors-api/)
- [Bem Entity Bulk Seed API](https://apis.io/apis/bem/bem-entity-bulk-seed-api/)
- [Bem Entity Curation API](https://apis.io/apis/bem/bem-entity-curation-api/)
- [Bem Entity Synonyms API](https://apis.io/apis/bem/bem-entity-synonyms-api/)
- [Bem Entity Type Reviewers API](https://apis.io/apis/bem/bem-entity-type-reviewers-api/)
- [Bem Entity Types API](https://apis.io/apis/bem/bem-entity-types-api/)
- [Bem Errors API](https://apis.io/apis/bem/bem-errors-api/)
- [Bem Feedback API](https://apis.io/apis/bem/bem-feedback-api/)
- [Bem File System API](https://apis.io/apis/bem/bem-file-system-api/)
- [Bem Function Accuracy API](https://apis.io/apis/bem/bem-function-accuracy-api/)

## Tags

Collection

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/bem/bem-collections-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/bem/.