CAH Serverless API

A blazing fast, zero-maintenance serverless API for Cards Against Humanity cards. Serves card metadata, full packs, random counts, and combined decks over global CDNs.

View on GitHub JSON Against Humanity

API Explorer

Test the serverless endpoints in real-time. Select a preset or customize the path below.

https://api-url.com

STATUS: -

Click "Send Request" to fetch data...

Available Endpoints

All endpoints respond in JSON format, support CORS, and are automatically cached for fast response times.

Method	Endpoint	Description
GET	/api/sets	List all available card packs including metadata (name, official status, sheet source).
GET	/api/sets/:id	Retrieve a complete pack including all white (answers) and black (prompts) cards.
GET	/api/sets/:id?n=5	Retrieve `n` random white cards from a specific pack.
GET	/api/multi?sets=0,1	Combine cards from multiple packs (comma-separated list of IDs) into a single object.
GET	/api/sheets	List all unique sheet sources (e.g. `CAH Packs`, `Fan Expansions`).
GET	/api/sheets/:id	Retrieve all sets associated with the given slugified sheet ID (e.g. `cah-packs`).

Frequently Asked Questions

Where does the card data come from?: All card sets are fetched dynamically from the curated JSON Against Humanity project. Caching is handled on the serverless layer to keep responses fast and reliable.
How does caching work?: To minimize external API request overhead and stay within serverless runtime limits, card datasets are loaded into memory and cached. First requests load the data, and subsequent calls fetch immediately from memory.
Is it free to use?: Yes! The API is designed to run efficiently on free-tier hosting networks like Vercel and Netlify which provide generous bandwidth and serverless allowances.
Can I use this in my own client app?: Absolutely! CORS is fully enabled on all endpoints, allowing you to fetch deck data using simple fetch() calls from anywhere.