Library Detail¶
GET /api/v1/libraries/{slug}
Return a single library by its URL slug.
Auth required: No (but see visibility rules below)
Visibility rules¶
- Approved libraries are visible to everyone
- Pending libraries are visible only to the authenticated user who submitted them
- Rejected libraries are never returned
If you're the owner of a pending library, include your Authorization: Bearer header to see it.
Path parameters¶
| Parameter | Type | Description |
|---|---|---|
slug |
string | URL-friendly unique slug of the library |
Examples¶
Viewing your own pending library¶
Response (200 OK)¶
{
"id": 42,
"slug": "berlin-friedrichstr-12-corner-books",
"name": "Corner Books",
"description": "A cozy little free library near the park entrance.",
"photo_url": "/media/libraries/photos/corner-books.jpg",
"thumbnail_url": "/media/libraries/thumbnails/corner-books.jpg",
"lat": 52.52,
"lng": 13.405,
"address": "Friedrichstr. 12",
"city": "Berlin",
"country": "DE",
"postal_code": "10117",
"wheelchair_accessible": "yes",
"capacity": 50,
"is_indoor": false,
"is_lit": true,
"website": "https://littlefreelibrary.org/charter/12345",
"contact": "info@example.org",
"source": "OpenStreetMap",
"operator": "City Library Association",
"brand": "Little Free Library",
"created_at": "2025-06-15T14:30:00Z",
"is_favourited": false
}
The is_favourited field is true when the authenticated user has favourited this library, and false otherwise. For unauthenticated requests it is always false.
Errors¶
| Status | Cause |
|---|---|
404 |
Library not found or not visible to the current user |
429 |
Rate limit exceeded (see Rate Limiting) |