# 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`](/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](/sdk-reference#call-options)).
