What each version can change
Every change reaches sandbox before production, and is recorded in the changelog with what changed and what to do about it.
What your consumer must tolerate
From the first day:- Ignore fields you do not know, in every object and in the envelope.
- Accept enumeration values you do not know: a
processType,type,paymentMethod,directionoreventTypeyou have not seen is informational, never an error. - Switch on
eventTypewith a default branch that stores the event and does nothing else. - Read a missing key and
nullthe same way: in a webhook, a field with no value is left out; in an endpoint’s answer, it isnull.
Where the version is
- The OpenAPI file,
/investor-activity-api/openapi.yaml, carries it ininfo.version; the Download option on every reference page gives you the file. - The changelog lists every version, newest first.
- Nothing in a response or a webhook carries the API version: it is a property of the contract, not of a call.