Versioning
This is version 7 of the API, served under /v1. Responses can gain new fields at any time, so ignore fields you don't recognise. Request bodies are strict: an unknown field is refused. Enums are closed: a value that isn't documented is a bug to report, and a new value only ships with a new API version.
Nothing you rely on disappears without notice. An operation or an enum value that is going away is announced in this reference at least 30 days ahead: the operation is marked deprecated and says the date after which it is removed, and what to use instead; a value is named, with its date, on the schema it belongs to. The full list is x-fin-retirements in /openapi.json. Any other breaking change ships as a new API version with a list of what changed.
Send X-Request-Id (8–64 characters of [A-Za-z0-9._-]) to trace a request; the response echoes the id Fin used. Quote it when you report a problem.
Send X-End-User-IP and X-End-User-Agent with each request to say who is on the other end: the address and user agent your own server saw for the person using your app. Fin records them beside the request so that a security question about an account can be answered later, and uses them for nothing else — not rate limits, sign-in or any decision. Both are optional; an address that is not a valid IPv4 or IPv6 address is ignored, and the user agent is kept up to 512 characters. Send what your server observed, never a value your client supplied. With the SDK, pass endUser: { ip, userAgent } in each call's options (call options).