List Categories
curl --request GET \
--url https://api.legitmark.com/api/v2/categoriesconst options = {method: 'GET'};
fetch('https://api.legitmark.com/api/v2/categories', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.legitmark.com/api/v2/categories"
response = requests.get(url)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.legitmark.com/api/v2/categories"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"message": "Categories fetched successfully",
"category": "SUCCESS",
"data": [
{
"uuid": "25ed7133-f230-4d64-850d-0cfc698e2931",
"name": "Footwear",
"sides": [
"f47ac10b-58cc-4372-a567-0e02b2c3d479",
"bf98166d-7119-47f0-a4c5-88d67a28e3e6"
],
"media": "https://cdn.legitmark.com/categories/25ed7133-f230-4d64-850d-0cfc698e2931.png",
"feature": true,
"ordinal": 1,
"active": true,
"created_at": "2024-05-26T18:07:34.000Z",
"updated_at": "2025-11-26T15:45:05.000Z",
"has_brands": true
},
{
"uuid": "cc30b104-7c47-11ef-a623-02595575faeb",
"name": "Bag",
"sides": [
"3c14c21f-8134-11ef-9e85-02d0d7ecc26b",
"3c14e254-8134-11ef-9e85-02d0d7ecc26b"
],
"media": "https://cdn.legitmark.com/categories/cc30b104-7c47-11ef-a623-02595575faeb.png",
"feature": true,
"ordinal": 2,
"active": true,
"created_at": "2024-09-26T20:42:08.000Z",
"updated_at": "2025-11-26T16:21:04.000Z",
"has_brands": true
}
],
"rc_hit": true,
"rc_key": "categories:abc123",
"metadata": {
"total_count": 8,
"page_number": 1,
"total_pages": 1,
"page_size": 20
}
}Taxonomy
List Categories
Get all available categories for item classification. Enhanced v2 endpoint with improved filtering and search capabilities.
GET
/
api
/
v2
/
categories
List Categories
curl --request GET \
--url https://api.legitmark.com/api/v2/categoriesconst options = {method: 'GET'};
fetch('https://api.legitmark.com/api/v2/categories', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.legitmark.com/api/v2/categories"
response = requests.get(url)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.legitmark.com/api/v2/categories"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"message": "Categories fetched successfully",
"category": "SUCCESS",
"data": [
{
"uuid": "25ed7133-f230-4d64-850d-0cfc698e2931",
"name": "Footwear",
"sides": [
"f47ac10b-58cc-4372-a567-0e02b2c3d479",
"bf98166d-7119-47f0-a4c5-88d67a28e3e6"
],
"media": "https://cdn.legitmark.com/categories/25ed7133-f230-4d64-850d-0cfc698e2931.png",
"feature": true,
"ordinal": 1,
"active": true,
"created_at": "2024-05-26T18:07:34.000Z",
"updated_at": "2025-11-26T15:45:05.000Z",
"has_brands": true
},
{
"uuid": "cc30b104-7c47-11ef-a623-02595575faeb",
"name": "Bag",
"sides": [
"3c14c21f-8134-11ef-9e85-02d0d7ecc26b",
"3c14e254-8134-11ef-9e85-02d0d7ecc26b"
],
"media": "https://cdn.legitmark.com/categories/cc30b104-7c47-11ef-a623-02595575faeb.png",
"feature": true,
"ordinal": 2,
"active": true,
"created_at": "2024-09-26T20:42:08.000Z",
"updated_at": "2025-11-26T16:21:04.000Z",
"has_brands": true
}
],
"rc_hit": true,
"rc_key": "categories:abc123",
"metadata": {
"total_count": 8,
"page_number": 1,
"total_pages": 1,
"page_size": 20
}
}Query Parameters
Number of results per page
Required range:
1 <= x <= 100Page number
Required range:
x >= 1Search term for category names
Filter to only active categories
Response
200 - application/json
Categories retrieved successfully
Example:
"Categories fetched successfully"
Available options:
SUCCESS Example:
"SUCCESS"
Hide child attributes
Hide child attributes
Example:
"Bag"
Array of side UUIDs associated with this category
Media URL for the category image
Whether this category is featured
Display order
Whether this category has associated brands
Indicates if the response was served from cache
Example:
false
Cache key used for this response
Example:
"categories:abc123"