From e60531f820512f5343ff99ecc6e999646fb1f5bd Mon Sep 17 00:00:00 2001
From: PolinaLif <127746304+PolinaLif@users.noreply.github.com>
Date: Tue, 18 Aug 2026 13:29:06 +0300
Subject: [PATCH] FA-9767: support optiuonal uid field to fetch an  account Id
 value (#255)

---
 DESCRIPTION.md |  4 ++++
 openapi.yaml   | 22 +++++++++++++++++++++-
 2 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/DESCRIPTION.md b/DESCRIPTION.md
index e589a795..ce8ea712 100644
--- a/DESCRIPTION.md
+++ b/DESCRIPTION.md
@@ -190,6 +190,10 @@ _Note_ that not all error codes need to be in use!
 # Changelog
 All notable changes to this project will be documented in this file. Dates are displayed in UTC.
 
+### v0.9.13
+> 17 August 2026
+* Added optional `uid` on the `/v1/accounts` response. This is the provider's native account identifier; Fireblocks persists it from the fundable account.
+
 ### v0.9.12
 > 19 April 2026
 * Supporting Fraxtal on Mainnet.
diff --git a/openapi.yaml b/openapi.yaml
index 0458c7e8..94de3f77 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -1,7 +1,7 @@
 openapi: 3.0.0
 info:
   title: Fireblocks Network Link for Account Linking Partners
-  version: "0.9.12"
+  version: "0.9.13"
   contact:
     email: support@fireblocks.com
   license:
@@ -22,6 +22,9 @@ paths:
               In case the 3rd party supports an account type but the account doesn't
               contain any balance, it is expected the "balances"
               field to be an empty array.
+
+              Each account may optionally include `uid`, the provider's native account
+              identifier. Fireblocks persists this value from the fundable account.
       operationId: GET /accounts
       parameters:
         - name: X-FBAPI-KEY
@@ -53,6 +56,16 @@ paths:
                 type: array
                 items:
                   $ref: '#/components/schemas/Balance'
+              example:
+                - displayName: "Margin (Cross)"
+                  type: MARGIN
+                  uid: "3c4e2590-d333-4bdd-acd1-3edcdee85777"
+                  balances:
+                    - coinSymbol: USDT
+                      totalAmount: "195.172612"
+                      pendingAmount: "188.2315812"
+                      availableAmount: "10.333"
+                      creditAmount: "3.1"
         '400':
           description: Return custom error and error code here.
         '401':
@@ -1375,6 +1388,13 @@ components:
           nullable: true
         type:
           $ref : '#/components/schemas/Account_Type'
+        uid:
+          type: string
+          example: "3c4e2590-d333-4bdd-acd1-3edcdee85777"
+          description: >
+            Optional provider-side account identifier.
+            When present on the fundable account, Fireblocks persists it as the provider account id.
+            Omit this field, or set it to the account id value.
         balances:
           type: array
           items: