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
- iOS push notifications via APNs device token registration
- 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 |
| Push Notifications | iOS APNs device token registration and delivery behavior |
| 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 |
| Submit a Community Photo | Add a photo to an existing library |
| My Contributions | Track your own submissions, reports, and photos |
| Staff Moderation | Staff-only queues and status updates |
| Statistics | Platform-wide aggregate statistics |
| Errors | Error response format and status codes |
| Rate Limiting | Request limits and 429 handling |
| API Reference | Interactive OpenAPI / Swagger UI |