Apache BookKeeper website screenshot

Apache BookKeeper

Apache BookKeeper is a scalable, fault-tolerant, and low-latency storage service optimized for real-time workloads developed by the Apache Software Foundation. It provides a simple log-oriented storage abstraction called ledgers for reliable, replicated storage of sequential data. BookKeeper is used as the durable log storage layer in Apache Pulsar and other distributed messaging and stream processing systems. It provides a Java client API and an HTTP Admin REST API for cluster management, bookie monitoring, and auto-recovery operations.

Apache BookKeeper publishes 5 APIs on the APIs.io network, including Auto Recovery API, Bookies API, Configuration API, and 2 more. Tagged areas include Apache, Distributed Systems, Log Storage, Open Source, and Storage.

The Apache BookKeeper catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Apache BookKeeper’s developer surface includes documentation, getting-started guide, support, changelog, and 8 more developer resources.

48.2/100 developing ▼ -8.3 Agent 28/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemium
6 APIs 8 Features 5 Use Cases
ApacheDistributed SystemsLog StorageOpen SourceStorageStreaming

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 48.2/100 · developing
Contract Quality 11.9 / 25
Developer Ergonomics 4.8 / 20
Commercial Clarity 10.0 / 20
Operational Transparency 6.8 / 13
Governance 8.3 / 12
Discoverability 6.5 / 10
Agent readiness — 28/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 0 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/apache-bookkeeper: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 6

Individual APIs this provider publishes, each with its own machine-readable definition.

Apache BookKeeper Java Client API

The BookKeeper Java client API provides programmatic access for creating, writing, reading, and managing ledgers. It supports both the legacy LedgerHandle API and the newer Ledg...

Apache BookKeeper Auto Recovery API

Under-replication detection and bookie recovery operations.

Apache BookKeeper Bookies API

Bookie node management and status operations.

Apache BookKeeper Configuration API

Server configuration management.

Apache BookKeeper Ledgers API

Ledger management and inspection operations.

Apache BookKeeper Monitoring API

Health checks and metrics endpoints.

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Apache Bookkeeper Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Features 8

Notable capabilities this provider offers.

Ledger Storage

Append-only log segments called ledgers provide the foundational storage primitive for reliable sequential data storage.

Ensemble Replication

Data is written to a configurable ensemble of bookies with write quorum and ack quorum parameters for fault tolerance.

Auto-Recovery

Built-in under-replication detection and automatic ledger re-replication when bookie nodes fail.

HTTP Admin API

RESTful HTTP Admin API for managing ledgers, bookies, cluster configuration, and triggering recovery operations.

Metrics Export

Prometheus-format metrics endpoint for monitoring bookie performance and storage utilization.

Auditor Election

ZooKeeper-based leader election for the auditor role responsible for detecting under-replicated ledgers.

Garbage Collection

Configurable garbage collection for reclaiming storage from deleted or expired ledger data.

Journal and Ledger Storage

Separate journal and ledger storage paths optimized for sequential write throughput and random read performance.

Scroll for all 8

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Apache Bookkeeper Context

9 classes · 23 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Apache BookKeeper API Rules

5 rules · 3 warnings 2 info

SPECTRAL

Apache BookKeeper API Rules

17 rules · 3 errors 12 warnings 2 info

SPECTRAL

JSON Schema 9

Standalone JSON Schema definitions for this provider's data models.

AuditorInfo

1 properties

JSON SCHEMA

BookieInfo

2 properties

JSON SCHEMA

BookieList

0 properties

JSON SCHEMA

BookieState

4 properties

JSON SCHEMA

ClusterInfo

8 properties

JSON SCHEMA

GcStatus

1 properties

JSON SCHEMA

LedgerEntries

0 properties

JSON SCHEMA

LedgerList

0 properties

JSON SCHEMA

LedgerMetadata

7 properties

JSON SCHEMA

Scroll for all 9

JSON Structure 9

JSON Structure definitions describing this provider's data shapes.

Bookkeeper Admin Auditor Info Structure

0 properties

JSON STRUCTURE

Bookkeeper Admin Bookie Info Structure

0 properties

JSON STRUCTURE

Bookkeeper Admin Bookie List Structure

0 properties

JSON STRUCTURE

Bookkeeper Admin Bookie State Structure

0 properties

JSON STRUCTURE

Bookkeeper Admin Cluster Info Structure

0 properties

JSON STRUCTURE

Bookkeeper Admin Gc Status Structure

0 properties

JSON STRUCTURE

Bookkeeper Admin Ledger Entries Structure

0 properties

JSON STRUCTURE

Bookkeeper Admin Ledger List Structure

0 properties

JSON STRUCTURE

Bookkeeper Admin Ledger Metadata Structure

0 properties

JSON STRUCTURE

Scroll for all 9

Examples 5

Example request and response payloads for these APIs.

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Apache Bookkeeper Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Apache Bookkeeper Vulnerability Disclosure

security.txt · contact published

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Apache Bookkeeper Agentic Access

19 operations · 5 acting

19 operations · 5 acting

AGENTIC

Use Cases 5

What developers build with this provider.

Durable Log Storage

Serve as the replicated, durable write-ahead log for Apache Pulsar topics and distributed streaming systems.

Distributed Transaction Logs

Store distributed transaction log segments for systems requiring exactly-once semantics and durable commit records.

Metadata Store

Persist metadata and configuration data for distributed systems requiring consistent, replicated storage.

Stream Processing Storage

Provide low-latency, high-throughput sequential storage for real-time stream processing pipelines.

Cluster Administration

Monitor and manage BookKeeper clusters using the HTTP Admin API for operational visibility and recovery.

Integrations 5

Pre-built integrations with other platforms and tools.

Apache Pulsar

BookKeeper serves as the durable log storage layer for Apache Pulsar messaging topics.

Apache ZooKeeper

ZooKeeper is used for bookie coordination, auditor election, and cluster metadata management.

Apache Hadoop

BookKeeper can be used with Hadoop ecosystem tools for reliable log storage alongside HDFS.

Prometheus

BookKeeper exports Prometheus-format metrics for cluster monitoring and alerting.

Grafana

Grafana dashboards consume BookKeeper Prometheus metrics for operational visibility.

Resources

Get Started 1

Portal, sign-up, and the first successful call

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

Build 2

SDKs, sample code, and the tooling you integrate with

Access & Security 2

Authentication, authorization, and security posture

Operate 2

Status, limits, changes, and where to get help

Commercial 1

Pricing, plans, and the legal terms of use

Source (apis.yml)

apis.yml Raw ↑
aid: apache-bookkeeper
name: Apache BookKeeper
description: Apache BookKeeper is a scalable, fault-tolerant, and low-latency storage service optimized for real-time workloads
  developed by the Apache Software Foundation. It provides a simple log-oriented storage abstraction called ledgers for reliable,
  replicated storage of sequential data. BookKeeper is used as the durable log storage layer in Apache Pulsar and other distributed
  messaging and stream processing systems. It provides a Java client API and an HTTP Admin REST API for cluster management,
  bookie monitoring, and auto-recovery operations.
type: Index
accessModel:
  pricing: freemium
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Freemium
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
position: Consumer
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/apache-bookkeeper.png
tags:
- Apache
- Distributed Systems
- Log Storage
- Open Source
- Storage
- Streaming
created: '2026-03-16'
modified: '2026-05-19'
url: https://raw.githubusercontent.com/api-evangelist/apache-bookkeeper/refs/heads/main/apis.yml
specificationVersion: '0.19'
apis:
- aid: apache-bookkeeper:apache-bookkeeper-java-client
  name: Apache BookKeeper Java Client API
  description: The BookKeeper Java client API provides programmatic access for creating, writing, reading, and managing ledgers.
    It supports both the legacy LedgerHandle API and the newer Ledger API with explicit durability guarantees.
  humanURL: https://bookkeeper.apache.org/docs/api/ledger-api
  tags:
  - Java
  - Ledger
  - Storage
  properties:
  - type: Documentation
    url: https://bookkeeper.apache.org/docs/api/ledger-api
  - type: APIReference
    url: https://bookkeeper.apache.org/docs/api/javadoc/
- aid: apache-bookkeeper:apache-bookkeeper-auto-recovery-api
  name: Apache BookKeeper Auto Recovery API
  description: Under-replication detection and bookie recovery operations.
  humanURL: https://bookkeeper.apache.org/docs/admin/http
  baseURL: http://localhost:8080
  tags:
  - Auto Recovery
  properties:
  - type: OpenAPI
    url: openapi/apache-bookkeeper-auto-recovery-api-openapi.yml
  - type: Documentation
    url: https://bookkeeper.apache.org/docs/admin/http
  - type: GettingStarted
    url: https://bookkeeper.apache.org/docs/getting-started/installation
- aid: apache-bookkeeper:apache-bookkeeper-bookies-api
  name: Apache BookKeeper Bookies API
  description: Bookie node management and status operations.
  humanURL: https://bookkeeper.apache.org/docs/admin/http
  baseURL: http://localhost:8080
  tags:
  - Bookies
  properties:
  - type: OpenAPI
    url: openapi/apache-bookkeeper-bookies-api-openapi.yml
  - type: Documentation
    url: https://bookkeeper.apache.org/docs/admin/http
  - type: GettingStarted
    url: https://bookkeeper.apache.org/docs/getting-started/installation
- aid: apache-bookkeeper:apache-bookkeeper-configuration-api
  name: Apache BookKeeper Configuration API
  description: Server configuration management.
  humanURL: https://bookkeeper.apache.org/docs/admin/http
  baseURL: http://localhost:8080
  tags:
  - Configuration
  properties:
  - type: OpenAPI
    url: openapi/apache-bookkeeper-configuration-api-openapi.yml
  - type: Documentation
    url: https://bookkeeper.apache.org/docs/admin/http
  - type: GettingStarted
    url: https://bookkeeper.apache.org/docs/getting-started/installation
- aid: apache-bookkeeper:apache-bookkeeper-ledgers-api
  name: Apache BookKeeper Ledgers API
  description: Ledger management and inspection operations.
  humanURL: https://bookkeeper.apache.org/docs/admin/http
  baseURL: http://localhost:8080
  tags:
  - Ledgers
  properties:
  - type: OpenAPI
    url: openapi/apache-bookkeeper-ledgers-api-openapi.yml
  - type: Documentation
    url: https://bookkeeper.apache.org/docs/admin/http
  - type: GettingStarted
    url: https://bookkeeper.apache.org/docs/getting-started/installation
- aid: apache-bookkeeper:apache-bookkeeper-monitoring-api
  name: Apache BookKeeper Monitoring API
  description: Health checks and metrics endpoints.
  humanURL: https://bookkeeper.apache.org/docs/admin/http
  baseURL: http://localhost:8080
  tags:
  - Monitoring
  properties:
  - type: OpenAPI
    url: openapi/apache-bookkeeper-monitoring-api-openapi.yml
  - type: Documentation
    url: https://bookkeeper.apache.org/docs/admin/http
  - type: GettingStarted
    url: https://bookkeeper.apache.org/docs/getting-started/installation
common:
- type: AgenticAccess
  url: agentic-access/apache-bookkeeper-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/apache-bookkeeper-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/apache-bookkeeper-domain-security.yml
- type: GitHubOrganization
  url: https://github.com/apache
- type: GitHubRepository
  url: https://github.com/apache/bookkeeper
- type: Documentation
  url: https://bookkeeper.apache.org/
- type: GettingStarted
  url: https://bookkeeper.apache.org/docs/getting-started/installation
- type: Support
  url: https://bookkeeper.apache.org/community/mailing-lists
- type: TermsOfService
  url: https://www.apache.org/licenses/
- type: ChangeLog
  url: https://github.com/apache/bookkeeper/releases
- type: SpectralRules
  url: rules/apache-bookkeeper-spectral-rules.yml
- type: Vocabulary
  url: vocabulary/apache-bookkeeper-vocabulary.yaml
- type: Features
  data:
  - name: Ledger Storage
    description: Append-only log segments called ledgers provide the foundational storage primitive for reliable sequential
      data storage.
  - name: Ensemble Replication
    description: Data is written to a configurable ensemble of bookies with write quorum and ack quorum parameters for fault
      tolerance.
  - name: Auto-Recovery
    description: Built-in under-replication detection and automatic ledger re-replication when bookie nodes fail.
  - name: HTTP Admin API
    description: RESTful HTTP Admin API for managing ledgers, bookies, cluster configuration, and triggering recovery operations.
  - name: Metrics Export
    description: Prometheus-format metrics endpoint for monitoring bookie performance and storage utilization.
  - name: Auditor Election
    description: ZooKeeper-based leader election for the auditor role responsible for detecting under-replicated ledgers.
  - name: Garbage Collection
    description: Configurable garbage collection for reclaiming storage from deleted or expired ledger data.
  - name: Journal and Ledger Storage
    description: Separate journal and ledger storage paths optimized for sequential write throughput and random read performance.
- type: UseCases
  data:
  - name: Durable Log Storage
    description: Serve as the replicated, durable write-ahead log for Apache Pulsar topics and distributed streaming systems.
  - name: Distributed Transaction Logs
    description: Store distributed transaction log segments for systems requiring exactly-once semantics and durable commit
      records.
  - name: Metadata Store
    description: Persist metadata and configuration data for distributed systems requiring consistent, replicated storage.
  - name: Stream Processing Storage
    description: Provide low-latency, high-throughput sequential storage for real-time stream processing pipelines.
  - name: Cluster Administration
    description: Monitor and manage BookKeeper clusters using the HTTP Admin API for operational visibility and recovery.
- type: Integrations
  data:
  - name: Apache Pulsar
    description: BookKeeper serves as the durable log storage layer for Apache Pulsar messaging topics.
  - name: Apache ZooKeeper
    description: ZooKeeper is used for bookie coordination, auditor election, and cluster metadata management.
  - name: Apache Hadoop
    description: BookKeeper can be used with Hadoop ecosystem tools for reliable log storage alongside HDFS.
  - name: Prometheus
    description: BookKeeper exports Prometheus-format metrics for cluster monitoring and alerting.
  - name: Grafana
    description: Grafana dashboards consume BookKeeper Prometheus metrics for operational visibility.
maintainers:
- FN: Kin Lane
  email: info@apievangelist.com