Update versions

Author: iffy

protocol-v1.md

@@ -1,7 +1,7 @@
 
 <img src="img/logo.svg" style="width: 32px; height: 32px;" align="center"> SimpleFIN Protocol
 
-- Version: VERSIONTAG-draft
+- Version: 1.0.7
 
 # Introduction
 

protocol.html

@@ -85,6 +85,7 @@
 <ul>
 <li><a href="#introduction" id="toc-introduction">Introduction</a>
 <ul>
+<li><a href="#older-versions" id="toc-older-versions">Older versions</a></li>
 <li><a href="#flow" id="toc-flow">Flow</a></li>
 <li><a href="#simplefin-bridge" id="toc-simplefin-bridge">SimpleFIN Bridge</a></li>
 </ul></li>
@@ -113,7 +114,6 @@
 </ul></li>
 <li><a href="#changes" id="toc-changes">Changes</a>
 <ul>
-<li><a href="#v2.0.0---2025-12-08" id="toc-v2.0.0---2025-12-08">v2.0.0 - 2025-12-08</a></li>
 <li><a href="#v1.0.7" id="toc-v1.0.7">v1.0.7</a></li>
 </ul></li>
 </ul>
@@ -127,7 +127,7 @@
 SimpleFIN Protocol
 </div>
 </div>
-<p>Version: 2.0.0-draft</p>
+<p>Version: 1.0.7-draft</p>
 <h1 id="introduction">Introduction</h1>
 <p>The SimpleFIN protocol allows users to share read-only financial data with third parties. It’s similar to RSS, but for financial data.</p>
 <p>Though intended mostly for banks, it can also be used for reward points or gift certificate balances (e.g. Frequent Flyer Miles, Amazon gift card balance, etc…)</p>
@@ -157,6 +157,8 @@ <h1 id="introduction">Introduction</h1>
 <p>Application developers should start with the <a href="#app-quickstart">App Quickstart</a>.</p>
 <p>Banks or financial institutions wanting to host their own SimpleFIN Server should start at the <a href="#server-implementation-guide">Server Implementation Guide</a>.</p>
 <p>Users should visit the <a href="https://bridge.simplefin.org">SimpleFIN Bridge</a>.</p>
+<h2 id="older-versions">Older versions</h2>
+<p><a href="/protocol-v1.html">SimpleFIN Version 1</a></p>
 <h2 id="flow">Flow</h2>
 <p>This diagram shows how a User gives read-only bank account access to an App:</p>
 <p><img src="img/connect-flow.svg" /></p>
@@ -758,7 +760,7 @@ <h2 id="get-info">GET /info</h2>
 <section>
 <div class="main">
 <p>Used by Applications to find out what versions of the SimpleFIN Protocol the server supports. The strings returned must be in <code>MAJOR.MINOR.FIX</code> or <code>MAJOR.MINOR</code> format.</p>
-<p>Note: as this specification is still in draft, most servers will report <code>1.0</code> but may not yet support all things from the draft specification.</p>
+<p>Note: as this specification is still in draft, most servers will report <code>1</code> but may not yet support all things from the draft specification.</p>
 <h3 id="http-request">HTTP Request</h3>
 <p><code>GET /info</code></p>
 <h3 id="response-json">Response JSON</h3>
@@ -782,7 +784,7 @@ <h3 id="response-json">Response JSON</h3>
 <div class="sourceCode" id="cb19"><pre class="sourceCode bash"><code class="sourceCode bash"><span id="cb19-1"><a href="#cb19-1" aria-hidden="true" tabindex="-1"></a><span class="ex">curl</span> https://bridge.simplefin.org/simplefin/info</span></code></pre></div>
 <p>Response:</p>
 <div class="sourceCode" id="cb20"><pre class="sourceCode json"><code class="sourceCode json"><span id="cb20-1"><a href="#cb20-1" aria-hidden="true" tabindex="-1"></a><span class="fu">{</span></span>
-<span id="cb20-2"><a href="#cb20-2" aria-hidden="true" tabindex="-1"></a>    <span class="dt">&quot;versions&quot;</span><span class="fu">:</span> <span class="ot">[</span><span class="st">&quot;1.0&quot;</span><span class="ot">]</span><span class="fu">,</span></span>
+<span id="cb20-2"><a href="#cb20-2" aria-hidden="true" tabindex="-1"></a>    <span class="dt">&quot;versions&quot;</span><span class="fu">:</span> <span class="ot">[</span><span class="st">&quot;1&quot;</span><span class="ot">,</span><span class="st">&quot;2&quot;</span><span class="ot">]</span><span class="fu">,</span></span>
 <span id="cb20-3"><a href="#cb20-3" aria-hidden="true" tabindex="-1"></a><span class="fu">}</span></span></code></pre></div>
 </div>
 </section>
@@ -899,6 +901,11 @@ <h3 id="http-request-3">HTTP Request</h3>
 <td>optional</td>
 <td>If <code>balances-only=1</code> is provided, no transaction data is returned.</td>
 </tr>
+<tr>
+<td>version</td>
+<td>optional</td>
+<td>Must be <code>2</code> for this version of the protocol. Can be <code>1</code> for earlier versions. The server chooses the default version if this is not specified.</td>
+</tr>
 </tbody>
 </table>
 <h3 id="authentication">Authentication</h3>
@@ -961,15 +968,6 @@ <h3 id="responses-1">Responses</h3>
 </div>
 </section>
 <h1 id="changes">Changes</h1>
-<h2 id="v2.0.0---2025-12-08">v2.0.0 - 2025-12-08</h2>
-<ul>
-<li><strong>BREAKING CHANGE:</strong> Deprecated <code>errors</code> list on <code>AccountSet</code> object in favor of new <code>errlist</code> list for structured errors.</li>
-<li><strong>BREAKING CHANGE:</strong> Deprecated <code>Organization</code> object in favor of new, flatter <code>Connection</code> object.</li>
-<li><strong>NEW:</strong> Added <code>GET /accounts?balances-only=1</code> parameter to skip fetching account transaction data.</li>
-<li><strong>NEW:</strong> Added <code>connections</code> list to <code>AccountSet</code></li>
-<li><strong>NEW:</strong> Added <code>GET /accounts?account=</code> parameter for filtering which accounts are returned.</li>
-<li><strong>NEW:</strong> Added <code>conn_id</code> to <code>Account</code> object to disambiguate between two different logins to the same bank.</li>
-</ul>
 <h2 id="v1.0.7">v1.0.7</h2>
 <ul>
 <li>Started this changelog</li>

protocol.md

@@ -569,7 +569,7 @@ ROOT="https://bridge.simplefin.org/simplefin"
 
 Used by Applications to find out what versions of the SimpleFIN Protocol the server supports. The strings returned must be in `MAJOR.MINOR.FIX` or `MAJOR.MINOR` format.
 
-Note: as this specification is still in draft, most servers will report `1` but may not yet support all things from the draft specification.
+Note: as this specification is still in draft, most servers will report `1` or `2` but may not yet support all things from the draft specification.
 
 ### HTTP Request