Menu

Versioning

/v1 only grows. Code written against it keeps working.

What can change in /v1

• New endpoints and new apps.
• New optional inputs.
• New fields in answers, and new values where the reference says a list is open-ended.

So ignore fields you don’t know, and don’t fail on a new value you haven’t seen.

What never changes in /v1

Removing or renaming anything, making an input required, or changing what a field means. Changes like that come as /v2, announced well ahead in the API changelog, with /v1 kept running for at least 12 months after.

Each endpoint in the reference shows the month it was added.