Where it is
One document per documented version:X-Api-Version. See Versioning.
What it carries
Every operation, with its request and response schemas, its error bodies, and a real example on each. Each operation also declares its own servers, sandbox first, so a client generated from it points at sandbox until you change it.Generating a client
Any OpenAPI 3.1 generator works. Two things worth knowing before you trust what comes out: Most amounts are strings. A generator will type those as strings because that is what they are. Keep them that way and parse them as decimals. A generator that offers to coerce them to numbers is offering to round your money. Parse amounts as decimals lists the ones that take another shape. A field being present in a schema is not a promise it always arrives. Most response schemas mark no field asrequired, and the few that still do lose it as each endpoint is rewritten. Treat every response field as optional whatever the schema says, and handle its absence rather than trusting a generated non-null type.