Get Category

Retrieve a specific category by its slug

GET /api/categories/:slug

Get Category

cURL

curl --request GET \
  --url https://api.example.com/api/categories/:slug

{
  "category": {
    "_id": "507f1f77bcf86cd799439011",
    "name": "Technology",
    "slug": "technology",
    "description": "Articles about technology and innovation",
    "createdAt": "2024-01-15T10:30:00.000Z"
  }
}

Retrieves a single category identified by its URL-friendly slug. This endpoint is publicly accessible and does not require authentication.

Request

Path Parameters

slug · string · required

The URL-friendly identifier of the category (e.g., “technology”, “travel”)

Headers

No authentication required.

Response

category · object

The requested category object

Show Properties

_id · string

Unique identifier for the category

name · string

Display name of the category

slug · string

URL-friendly identifier for the category

description · string

Optional description of the category

createdAt · string

ISO 8601 timestamp of when the category was created

{
  "category": {
    "_id": "507f1f77bcf86cd799439011",
    "name": "Technology",
    "slug": "technology",
    "description": "Articles about technology and innovation",
    "createdAt": "2024-01-15T10:30:00.000Z"
  }
}

Error Responses

error · string

Error message describing what went wrong

404 - Category Not Found

Returned when no category exists with the specified slug.

{
  "error": "Category not found"
}

500 - Internal Server Error

{
  "error": "Database connection failed"
}

Example Request

cURL

curl https://api.vaniyk-empire.com/api/categories/technology