ListServ Server

ListServ is a lightweight, high-performance reference data service designed to efficiently manage and serve mostly static datasets. Instantly transform any JSON array to standard APIs

Get Started Guide

Ecosystem & Tools

ListServCLI

A powerful open-source npm tool for command-line administration of ListServ instances. Manage API keys, datasets, items, health, and distributed instances.

View CLI on GitHub

ListServ Stor

A repository of standardized reference datasets (countries, currencies, etc.) ready to be used with ListServ Server. Find and download datasets quickly.

Visit ListServ Stor

API Explorer

A browser-based tool to interactively test ListServ item API endpoints. Provide your server URL, Dataset ID, and parameters to make live API calls.

Open API Explorer

Ideal Use Cases

Global reference data (e.g., countries, currencies, languages)
Product catalogs and taxonomies
Standard code lists (e.g., ISO, UN, IATA)
Static metadata for frontend apps (e.g., dropdowns, filters)
Read-heavy services in distributed systems
Mock API generation from JSON samples

If you’ve ever found yourself serving static JSON files from an S3 bucket or maintaining a CRUD app just to handle lookup tables—ListServ is for you.

Core Features

Explore the key capabilities that make ListServ Server efficient and versatile.

Cost Effective & Lightweight

Stores standardized JSON datasets via a unified persistence interface (Azure Blob, Local FS by default). Loads data on demand with preloading for frequently accessed datasets to minimize latency.

High Performance

Utilizes in-memory caching with intelligent eviction and efficient indexing (including simple text searches and suffix trees). Built on .NET 9 Minimal APIs for minimal overhead and rapid startup.

Built-in Security & Rate Limiting

Optional API key security with keys stored encrypted and loaded into memory. Configurable rate limiting per client IP and comprehensive CORS policies protect the service.

Pluggable Persistence

Supports Azure Blob Storage and Local File System out-of-the-box. Easily extend with custom providers (e.g., Amazon S3, Google Cloud Storage) by implementing the defined interface.

Distributed Orchestration

Supports multi-instance deployments via a simple leader/follower orchestration pattern. Orchestration data is managed through a pluggable provider model (default: Azure Blob Storage).

Easy Integration & Management

Fully configurable through environment variables and configuration files. Available as a Docker container for easy deployment. Manageable via the ListServCLI.