Skip to navigation

Get the Company Classification Taxonomy

View as Markdown

Returns active classification buckets and standardized categories with counts and accepted alias[] spellings, plus every active tag[] and standardized classification[] row unless includeTags=false. The full payload exceeds 1 MB: agents pass includeTags=false for metadata only, or bucketType to scope one bucket. To find one value, prefer the paginated classification tag list with category and q filters. Inactive tags are omitted.

Authentication

AuthorizationBearer

Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token

Query parameters

bucketTypestringOptional

Filter editorial buckets by a returned type or alias (e.g. industry, typeCustomer, revenueModel). Case- and punctuation-insensitive. Does not filter standardized categories; use the classification tag list category filter for those.

includeTagsbooleanOptional

When false, returns bucket and category metadata and counts with empty tag[] and classification[] arrays. For one value, use the paginated classification tag list with category and q.

Response headers

X-RateLimit-LimitintegerOptional

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

X-RateLimit-RemainingintegerOptional

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

X-RateLimit-ResetintegerOptional

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

Response

OK
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