Skip to navigation
aVenture APICompaniesEntity Acquisitions

Get One Company Acquisition

View as Markdown

Returns an acquisition only when both the buyer and the acquired entity are published. A 404 for an acquisition that the entity relationships resource lists means the record exists but one side is not published. A gated miss on an existing row returns 404 with title ‘Acquisition Exists but a Counterpart Entity Is Not Public’. The acquired/acquirer roles in each row are always declared explicitly in the response via the acquiredEntity and acquirerEntity fields. The role query parameter selects which side of the acquisition the path entity is on: 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.

Authentication

AuthorizationBearer

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

Path parameters

entityIdstringRequiredformat: "uuid"
Entity UUID whose acquisition rows are being read or written.
relationshipIdintegerRequired
Integer id of the acquisition record.

Query parameters

roleenumOptional

Which side the path entity occupies for this relationshipId: acquired (default) returns the record only when the path entity was bought; acquirer returns it only when the path entity was the buyer; all returns it from either side. A side mismatch returns 404.

Allowed values:

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
acquiredEntityobject

The acquired company (the entity in the request path); read-only.

acquirerEntityobject

The buyer; read-only. Mutations identify the buyer only via the flat acquirerEntityId UUID, never a nested entity object.

evidenceobject
Booleans confirming each managed row written by the acquisition endpoint.
relationshipIdinteger
statusenum
Acquisition stage of the acquired entity, not the deal's transactionStatus
Allowed values:
amountlong or nullOptional
announcedAtstring or nullOptionalformat: "^(?!0000)[0-9]{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12][0-9]|3[01])(?:T(?:[01][0-9]|2[0-3]):[0-5][0-9](?::[0-5][0-9](?:\.[0-9]{1,9})?)?(?:Z|[+-](?:(?:0[0-9]|1[0-7]):[0-5][0-9]|18:00)))?)?)?$"
Acquisition announcement date or instant, retaining its stored precision.
asOfstring or nullOptionalRead-onlyformat: "^(?!0000)[0-9]{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12][0-9]|3[01])(?:T(?:[01][0-9]|2[0-3]):[0-5][0-9](?::[0-5][0-9](?:\.[0-9]{1,9})?)?(?:Z|[+-](?:(?:0[0-9]|1[0-7]):[0-5][0-9]|18:00)))?)?)?$"

Effective acquisition date the server derives on write: announcedAt, else completedAt, else the submitted asOf, as a calendar day; it can differ from the asOf written.

completedAtstring or nullOptionalformat: "^(?!0000)[0-9]{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12][0-9]|3[01])(?:T(?:[01][0-9]|2[0-3]):[0-5][0-9](?::[0-5][0-9](?:\.[0-9]{1,9})?)?(?:Z|[+-](?:(?:0[0-9]|1[0-7]):[0-5][0-9]|18:00)))?)?)?$"
Acquisition completion date or instant, retaining its stored precision.
createdAtdatetime or nullOptional
currencystring or nullOptional
dataConfidenceenum or nullOptional
Fundraise data confidence label
Allowed values:
fundraiseTransactionIdstring or nullOptionalformat: "uuid"

Funding round id (UUID)

investorJoinIdstring or nullOptionalformat: "uuid"
Identifier of one investor's participation in a funding round
isCurrentboolean or nullOptional
Whether the buyer still owns the acquired company, not whether the company is operating. False retains the prior ownership event on this relationship.
publicSourceobject or nullOptional

Published page behind this acquisition, read from the provenance event that wrote it; absent for internal sources.

transactionStatusenum or nullOptional
Fundraise transaction status label
updatedAtdatetime or nullOptional

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