diff --git a/services-satellite/api-service/readme.md b/services-satellite/api-service/readme.md
new file mode 100644
index 00000000..33b36b08
--- /dev/null
+++ b/services-satellite/api-service/readme.md
@@ -0,0 +1,7 @@
+# API
+
+The API service acts as a gateway for public API requests, it deals with API keys and rate limiting and so on.
+
+## Central Classes
+
+* [ApiService](src/main/java/nu/marginalia/api/ApiService.java) handles REST requests and delegates to the appropriate handling classes. 
\ No newline at end of file