Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.legitmark.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Legitmark uses a four-level hierarchical classification system. Each level determines authentication requirements and service selection: Hierarchy Levels:
  • Level 1: Category (Required) - Broad product classification
  • Level 2: Type (Required) - Specific product subcategory
  • Level 3: Brand (Optional) - Manufacturer or designer
  • Level 4: Model (Optional) - Specific product variant

​
Getting taxonomy data

​
Complete tree

Get everything in one request for initial setup: API Reference: Get Taxonomy Tree - GET /api/v2/categories/tree 
const response = await fetch('https://api.legitmark.com/api/v2/categories/tree?active_only=true', {
  headers: { 'Authorization': 'Bearer leo_xxxxxxxxx' }
});
const { data: categories, metadata } = await response.json();
The taxonomy tree includes category and type (required), plus brand and model (optional). Matching on brand and model is highly recommended to get more specific image requirements based on full taxonomy depth. If brand and model are not matched, there may be additional photos required for authentication.

​
Key filtering endpoints

​
Additional endpoints

​
Integration approaches

​
Use our taxonomy directly

Present Legitmark categories to your users: 
const response = await fetch('https://api.legitmark.com/api/v2/categories?active_only=true', {
  headers: { 'Authorization': 'Bearer leo_xxxxxxxxx' }
});
const { data } = await response.json();

data.forEach(category => {
  console.log(category.name); // "Bags", "Shoes", etc.
});

​
Get brands for a selected type

const response = await fetch(
  `https://api.legitmark.com/api/v2/types/${typeUuid}/brands`,
  { headers: { 'Authorization': 'Bearer leo_xxxxxxxxx' } }
);
const { data: brands } = await response.json();

​
Map your existing categories

Translate your platform’s categories to ours: 
const categoryMap = {
  "Designer Handbags": "bags-category-uuid",
  "Athletic Shoes": "shoes-category-uuid"
};

function getLegitmarkCategory(yourCategory) {
  return categoryMap[yourCategory];
}

​
Caching

Cache taxonomy data to improve performance. The taxonomy catalog changes over time as new brands and categories are added, so regular synchronization is important: 
class TaxonomyCache {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.data = null;
    this.lastFetch = null;
  }

  async getTree() {
    const maxAge = 24 * 60 * 60 * 1000; // 24 hours
    
    if (this.data && Date.now() - this.lastFetch < maxAge) {
      return this.data;
    }

    const response = await fetch('https://api.legitmark.com/api/v2/categories/tree?active_only=true', {
      headers: { 'Authorization': `Bearer ${this.apiKey}` }
    });
    
    this.data = await response.json();
    this.lastFetch = Date.now();
    
    return this.data;
  }
}
Sync daily to capture new categories, brands, and models as they’re added to the platform.

​
Next steps

  1. Setup your Workflow - Step-by-step process from service request creation to image upload
  2. Learn about States - Service request states and workflow transitions

​
Quick reference