Book Corners API¶
Welcome to the Book Corners API — a REST API for discovering, submitting, and reporting little free libraries around the world.
Base URL¶
Features¶
- Search & discover libraries by text, city, country, postal code, or proximity
- Submit new library locations with photos for community moderation
- Report issues with existing libraries (damaged, missing, incorrect info)
- JWT authentication with access/refresh token lifecycle
- Geospatial queries powered by PostGIS
Quick links¶
| Topic | Description |
|---|---|
| Getting Started | Register, authenticate, and make your first request |
| Authentication | Token lifecycle and all auth endpoints |
| List & Search | Browse and search the library catalogue |
| Submit a Library | Add a new library with a photo |
| Report an Issue | Flag problems with a library |
| Errors | Error response format and status codes |
| Rate Limiting | Request limits and 429 handling |
| API Reference | Interactive OpenAPI / Swagger UI |