Get the company classification taxonomy

GET

https://api.aventure.vc/v1/classifications/catalog

GET

/v1/classifications/catalog

curl -G https://api.aventure.vc/v1/classifications/catalog \
     -H "Authorization: Bearer <token>" \
     -d bucketType=industry

{
  "bucket": [
    {
      "alias": [
        "string"
      ],
      "creatable": true,
      "hierarchical": true,
      "label": "string",
      "tag": [
        {
          "creatable": true,
          "name": "string",
          "writable": true,
          "id": 1,
          "type": "industry",
          "isCurrent": true,
          "isPrimary": true,
          "bucket": "string",
          "classificationId": 1,
          "createdAt": "2024-01-15T09:30:00Z",
          "slug": "aventure-vc",
          "updatedAt": "2024-01-15T09:30:00Z"
        }
      ],
      "tagCount": 1,
      "type": "string",
      "writable": true,
      "bucket": "string"
    }
  ],
  "category": [
    {
      "alias": [
        "string"
      ],
      "category": "string",
      "classification": [
        {
          "creatable": true,
          "name": "string",
          "writable": true,
          "category": "string",
          "id": 1,
          "isCurrent": true,
          "isPrimary": true,
          "code": 1,
          "createdAt": "2024-01-15T09:30:00Z",
          "entityClassificationId": 1,
          "level": 1,
          "updatedAt": "2024-01-15T09:30:00Z"
        }
      ],
      "classificationCount": 1,
      "creatable": true,
      "hierarchical": true,
      "label": "string",
      "writable": true
    }
  ],
  "generatedAt": "2024-01-15T09:30:00Z",
  "totalBucket": 1,
  "totalCategory": 1,
  "totalStandardizedClassification": 1,
  "totalTag": 1
}

Returns active classification buckets with optional tag lists. Each bucket carries its canonical type, accepted alias[] spellings, tagCount, and (when includeTags=true) the active tag[]. Use bucketType to scope to one bucket and includeTags=false to fetch metadata only. For tag ids, prefer classifications list --category <bucket> --q <name> over broad catalog JSON; use returned tag.id as EntityClassificationMutation.tagId when writing classifications. Dormant registry tags are intentionally omitted; type + name writes that find one return 409 with inactiveTagOverride recovery choices.

Returns active classification buckets with optional tag lists. Each bucket carries its canonical `type`, accepted `alias[]` spellings, `tagCount`, and (when includeTags=true) the active `tag[]`. Use bucketType to scope to one bucket and includeTags=false to fetch metadata only. For tag ids, prefer `classifications list --category <bucket> --q <name>` over broad catalog JSON; use returned tag.id as EntityClassificationMutation.tagId when writing classifications. Dormant registry tags are intentionally omitted; type + name writes that find one return 409 with inactiveTagOverride recovery choices.

Authentication

AuthorizationBearer

User bearer token: Clerk session JWT, Clerk OAuth access token, or Clerk API key

Query parameters

bucketTypestringOptional

Optional classification bucket. Accepts the same values as the tags endpoint type parameter.

includeTagsbooleanOptional

When false, returns bucket metadata without tag arrays. For tag ids, prefer classifications list with category and q filters instead of broad catalog JSON.

Response headers

X-RateLimit-Limitinteger

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-Remaininginteger

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-Resetinteger

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

bucketlist of objects

categorylist of objects

generatedAtdatetime

totalBucketinteger

totalCategoryinteger

totalStandardizedClassificationinteger

totalTaginteger

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

406

Not Acceptable Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error