aVenture APIEntity Classifications

List a company's classifications

View as Markdown

Returns joins grouped by bucket. The default view includes current rows; includeInactive=true adds historical rows and requires read auth. Callers with private-visibility authority can also resolve hidden or private entities; setting includePrivate=true requires that authority. Signed-in callers without it can access public entities, while hidden entities return 404.

Authentication

AuthorizationBearer

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

Path parameters

entityIdstringRequiredformat: "uuid"
Canonical entity UUID

Query parameters

includeInactivebooleanOptionalDefaults to false

Include inactive/historical entity classification join rows; default false returns only current joins.

includePrivatebooleanOptional

Includes private or hidden entity classification rows when the caller has private-visibility authority. Omit to use the caller’s default visibility.

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

OK
geoLocationExposurelist of objectsOptionalDefaults to []

Geographic markets where the entity earns revenue and serves customers (e.g. North America, EMEA, APAC). This is the sales/market footprint classification — NOT the HQ or office location. HQ and office locations belong on the address record (enrichment.address), not this bucket. A London-headquartered company selling globally should have North America and EMEA here, not United Kingdom.

industrylist of objectsOptionalDefaults to []
Industry filter values
mainProductlist of objectsOptionalDefaults to []
Main product filter values
standardizedClassificationlist of objectsOptionalDefaults to []

Standardized classification joins from res_classification_ref. Rows are join-existing-only and carry category/code metadata.

taglist of objectsOptionalDefaults to []
Tag filter values
typeCustomerlist of objectsOptionalDefaults to []
Type customer filter values
typeModellist of objectsOptionalDefaults to []
Type model filter values
typeOwnershiplist of objectsOptionalDefaults to []
Type ownership filter values
typeRevenuelist of objectsOptionalDefaults to []
Type revenue filter values
typeTechnologyUsedlist of objectsOptionalDefaults to []
Type technology used filter values

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
406
Not Acceptable Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error