aVenture APIEntity Acquisitions

Create acquisition event for an entity

View as Markdown
Writes the managed acquisition graph for the acquired entity: acquirer relationship, Acquisition fundraise transaction, and acquirer investor join. Operating status changes only when completedAt is present or transactionStatus is Completed/Closed; announced/pending acquisitions keep operating status unchanged and read status=Acquisition. Do not also create a generic parent relationship for the same entity pair.

Authentication

AuthorizationBearer

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

OR
X-API-Keystring

Admin API key for system-to-system write operations

Path parameters

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

Query parameters

sourceTypeenumRequired
Write provenance source type.
sourceDetailstringRequired
Source detail or reviewer reference for the write.
sourceProviderstringOptional

Provider name for provider-native IDs or slugs.

sourceProviderIdstringOptional

Provider-native source ID.

sourceProviderSlugstringOptional

Provider-native source slug.

actorTypeenumOptional

Actor type; inferred as agent when agentChassis and agentModel are supplied, or as employee from an authenticated user JWT session.

Allowed values:
agentChassisstringOptional

Agent chassis token for agent-authored writes.

agentModelstringOptional

Agent model id for agent-authored writes.

Request

This endpoint expects an object.
acquirerEntityIdstring or nullOptionalformat: "uuid"

Buyer/acquirer entity id. Must differ from the acquired entityId path segment.

amountlong or nullOptional

Acquisition amount in currency units (full units, not minor); requires currency when supplied.

announcedAtstring or nullOptionalformat: "^(?:\d{4}|\d{4}-(?:0[1-9]|1[0-2])|(?:\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|02-(?:0[1-9]|1\d|2[0-8]))|(?:(?:[02468][048]|[13579][26])00|\d{2}(?:0[48]|[2468][048]|[13579][26]))-02-29)|(?:\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|02-(?:0[1-9]|1\d|2[0-8]))|(?:(?:[02468][048]|[13579][26])00|\d{2}(?:0[48]|[2468][048]|[13579][26]))-02-29)T(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d{1,9})?)?(?:Z|[+-](?:(?:0\d|1[0-7]):[0-5]\d|18:00)))$"

Announced acquisition date as an ISO offset date-time, date, year-month, or year. Coarse values normalize to the UTC period start; original precision is not persisted.

asOfdate or nullOptional
Effective date when announcedAt and completedAt are absent
completedAtstring or nullOptionalformat: "^(?:\d{4}|\d{4}-(?:0[1-9]|1[0-2])|(?:\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|02-(?:0[1-9]|1\d|2[0-8]))|(?:(?:[02468][048]|[13579][26])00|\d{2}(?:0[48]|[2468][048]|[13579][26]))-02-29)|(?:\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|02-(?:0[1-9]|1\d|2[0-8]))|(?:(?:[02468][048]|[13579][26])00|\d{2}(?:0[48]|[2468][048]|[13579][26]))-02-29)T(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d{1,9})?)?(?:Z|[+-](?:(?:0\d|1[0-7]):[0-5]\d|18:00)))$"

Completed acquisition date as an ISO offset date-time, date, year-month, or year. Coarse values normalize to the UTC period start; original precision is not persisted.

creatorstring or nullOptional
Creator label
currencystring or nullOptional
ISO 4217 currency code
dataConfidencestring or nullOptional
Data confidence level
sourcestring or nullOptional
Source URL or compact source label copied to the relationship row
transactionStatusstring or nullOptional
Transaction status

Response

Created
acquiredEntityobject

Acquired company — read-only nested display projection of the scoped path entity.

acquirerEntityobject

Buyer — read-only nested display projection. 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

Read stage, not transactionStatus: Acquisition before operating-status change; Acquired Subsidiary for active completed acquisitions; Acquired for terminal/folded/closed.

amountlong or nullOptional
announcedAtdatetime or nullOptional
asOfdate or nullOptional
completedAtdatetime or nullOptional
createdAtdatetime or nullOptional
currencystring or nullOptional
dataConfidenceenum or nullOptional
Fundraise data confidence label
fundraiseTransactionIdstring or nullOptionalformat: "uuid"
Canonical fundraise transaction UUID
investorJoinIdstring or nullOptionalformat: "uuid"

Type-safe identifier for fundraise investor joins

sourcestring or nullOptional
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
409
Conflict Error
415
Unsupported Media Type Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error