List acquisitions for an entity

View as Markdown
VISIBILITY-GATED READ: a row is returned only when BOTH the acquired and acquirer entities are publicly visible. An acquisition relationship that already exists (and is visible in the entity relationships resource) but returns 404 here means one counterpart entity is still hidden -- publish that entity (statusSitemapShow=true, statusHidePage=false) -- it is an unmet visibility prerequisite, not data-layer inconsistency or projection lag. The acquired/acquirer roles in each row are always declared explicitly in the response via the acquiredEntity and acquirerEntity fields. The role query parameter only selects which side the path entity occupies in the WHERE clause: acquired (default) lists acquisitions where the path entity was bought; acquirer lists acquisitions where the path entity was the buyer; all lists or reads both sides in one response. Writes (POST/PUT/PATCH/DELETE) ignore role and always treat the path entity as acquired. List responses are ordered by most recent acquisition event first.

Authentication

X-Client-Secretstring

Client secret for read-only service-to-service access (no writes)

Path parameters

entityIdstringRequiredformat: "uuid"
Entity UUID whose acquisition rows are being read or written.

Query parameters

roleenumOptional

Selects which side the path entity occupies in the WHERE clause: acquired (default) lists rows where the path entity was bought; acquirer lists rows where the path entity was the buyer; all lists both sides.

Allowed values:
pageintegerOptional>=0Defaults to 0

Zero-based page index (0..N)

sizeintegerOptional>=1Defaults to 20
The size of the page to be returned
sortlist of stringsOptional

Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.

Response

OK
contentlist of objectsOptional
emptybooleanOptional
firstbooleanOptional
lastbooleanOptional
numberintegerOptional
numberOfElementsintegerOptional
pageableobjectOptional
sizeintegerOptional
sortobjectOptional
totalElementslongOptional
totalPagesintegerOptional

Errors

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