API Documentation

Parks & Wildlife API

Access information about Kenya's national parks and wildlife reserves.

Endpoints

GET/api/parks

Returns a list of all national parks and reserves.

Response Format:

{
 "parks": [
   {
     "id": 1,
     "name": "Maasai Mara National Reserve",
     "location": "Narok County, Kenya",
     "description": "...",
     "famousFor": "Big Five, Wildebeest Migration",
     "imageUrl": "..."
   },
   ...
 ]
}

GET/api/parks/{id}

Returns details for a specific park by ID.

Response Format:

{
 "id": 1,
 "name": "Maasai Mara National Reserve",
 "location": "Narok County, Kenya",
 "description": "...",
 "famousFor": "Big Five, Wildebeest Migration",
 "imageUrl": "...",
 "animals": ["Lion", "Elephant", "Buffalo", "Leopard", "Rhino"],
 "bestTimeToVisit": "July to October",
 "entranceFees": {
   "foreignAdult": "$80",
   "foreignChild": "$45",
   "residentAdult": "KES 1,200",
   "residentChild": "KES 600"
 }
}

Authentication

All API requests require an API key. Include your API key in the request headers:

Authorization: Bearer YOUR_API_KEY

To obtain an API key, please register for an account on our developer portal.

Rate Limiting

API requests are limited to:

100 requests per minute for free tier
1,000 requests per minute for standard tier
10,000 requests per minute for premium tier

Rate limit information is included in the response headers:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1619012345