Skip to main content
GET
/
api
/
v2
/
categories
List Categories
curl --request GET \
  --url https://api.legitmark.com/api/v2/categories
{
  "message": "Categories fetched successfully",
  "category": "SUCCESS",
  "data": [
    {
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Bags",
      "description": "Luxury handbags and purses",
      "active": true,
      "created_at": "2024-01-01T00:00:00.000Z",
      "updated_at": "2024-01-01T00:00:00.000Z"
    },
    {
      "uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "Watches",
      "description": "Luxury timepieces and accessories",
      "active": true,
      "created_at": "2024-01-01T00:00:00.000Z",
      "updated_at": "2024-01-01T00:00:00.000Z"
    }
  ],
  "metadata": {
    "total_count": 8,
    "page_number": 1,
    "total_pages": 3,
    "page_size": 3
  },
  "rc_hit": true,
  "rc_key": "categories:b5cbcf6c3facb57bb9ef300495bdb0c4"
}

Query Parameters

page_size
integer
default:20

Number of results per page

Required range: 1 <= x <= 100
page_number
integer
default:1

Page number

Required range: x >= 1
search_query
string

Search term for category names

activeOnly
boolean
default:false

Filter to only active categories

Response

200 - application/json

Categories retrieved successfully

message
string
required
Example:

"Categories fetched successfully"

category
enum<string>
required
Available options:
SUCCESS
Example:

"SUCCESS"

data
object[]
required
rc_hit
boolean

Indicates if the response was served from cache

Example:

false

rc_key
string

Cache key used for this response

Example:

"categories:abc123"

metadata
object

Pagination metadata