List Classification Tags

GET

https://api.aventure.vc/v1/entities/classifications/tags

GET

/v1/entities/classifications/tags

curl -G https://api.aventure.vc/v1/entities/classifications/tags \
     -H "Authorization: Bearer <token>" \
     -d category=industry \
     -d search=enterprise

{
  "content": [
    {
      "bucket": "string",
      "classificationId": 1,
      "createdAt": "2024-01-15T09:30:00Z",
      "id": 1,
      "isCurrent": true,
      "isPrimary": true,
      "name": "string",
      "registry": "string",
      "slug": "aventure-vc",
      "type": "industry",
      "updatedAt": "2024-01-15T09:30:00Z"
    }
  ],
  "empty": true,
  "first": true,
  "last": true,
  "number": 1,
  "numberOfElements": 1,
  "pageable": {
    "offset": 1,
    "pageNumber": 1,
    "pageSize": 1,
    "paged": true,
    "sort": {
      "empty": true,
      "sorted": true,
      "unsorted": true
    },
    "unpaged": true
  },
  "size": 1,
  "sort": {
    "empty": true,
    "sorted": true,
    "unsorted": true
  },
  "totalElements": 1,
  "totalPages": 1
}

Returns a paginated list of editorial tags and standardized classifications. Filter by category using any bucket or standardized category spelling listed by the catalog, and by name with search. Sorting is not supported — sort returns 422.

Authentication

AuthorizationBearer

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

Query parameters

categorystringOptional

Classification bucket or standardized category. Case- and punctuation-insensitive.

searchstringOptional

Case-insensitive name substring filter (e.g. ‘enterprise’).

qstringOptionalDeprecated

Deprecated alias for search.

pageintegerOptional>=0Defaults to 0

Zero-based page index (0..N)

sizeintegerOptional>=1Defaults to 20

The size of the page to be returned

codeTextstringOptional

Exact supplied standardized code text; requires a standardized category.

codeintegerOptional

Exact legacy numeric code; requires a standardized category.

editionstringOptional

Exact supplied edition; omitted imposes no edition constraint.

hasEditionbooleanOptional

true selects recorded editions; false selects unknown edition.

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

contentlist of objectsOptional

emptybooleanOptional

firstbooleanOptional

lastbooleanOptional

numberintegerOptional

numberOfElementsintegerOptional

pageableobjectOptional

sizeintegerOptional

sortobjectOptional

totalElementslongOptional

totalPagesintegerOptional

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