Verticals
A vertical is a domain-specific inspection product — BuildingScan, CollectorScan, VehicleScan, and so on. Each vertical bundles its own catalog categories, grading schemas, and CV models under a single slug.
Listing public verticals
GET
/v1/verticalsList all public verticalsGET
/v1/verticals/{slug}Get a single vertical by slugimport { KliqClient } from '@kliq-ai/sdk';
const kliq = new KliqClient({ apiKey: process.env.KLIQ_API_KEY! });
// List all public verticals
const verticals = await kliq.verticals.list();
for (const v of verticals.data) {
console.log(v.slug, '-', v.name);
}
// building-scan - BuildingScan
// collector-scan - CollectorScan
// vehicle-scan - VehicleScan
// art-scan - ArtScan
// machine-scan - MachineScan
// infra-scan - InfraScan
// Fetch a specific vertical
const collector = await kliq.verticals.get('collector-scan');
console.log(collector.description);
// "Authentication, grading and registry for collectibles — trading cards,
// gemstones, watches, coins, wine and more."
Available public verticals
| Slug | Name | Domain |
|---|---|---|
building-scan | BuildingScan | Commercial buildings & FM |
collector-scan | CollectorScan | Collectibles: cards, gems, watches, coins, wine |
vehicle-scan | VehicleScan | Cars & motorcycles |
art-scan | ArtScan | Fine art & prints |
machine-scan | MachineScan | Industrial machinery |
infra-scan | InfraScan | Civil infrastructure |
Creating a custom vertical
Use kliq.verticals.create() to register a private vertical scoped to your tenant. Custom verticals are not visible to other tenants.
POST
/v1/verticalsCreate a custom verticalconst winescan = await kliq.verticals.create('t_abc123', {
slug: 'wine-scan',
name: 'WineScan',
description: 'Authentication and condition grading for fine wine bottles.',
brandColor: '#722F37',
});
console.log(winescan.id); // "vert_xyz789"
console.log(winescan.isPublic); // false — private to your tenant
Vertical slugs are globally unique
Choose a descriptive slug. If the slug is already taken by a public vertical you cannot create a duplicate — use a tenant-prefixed slug such as acme-wine-scan.
Next steps
- Grading Schemas — Define how items are graded within a vertical
- Catalog Registry — Browse and extend the public item catalog
- Inspection Flow — Run end-to-end inspections