docs(api): expose tags on account and operation responses

api-reference/fx-payment/reports/get-report.mdx

@@ -0,0 +1,5 @@
+---
+title: "Get a report"
+description: "Aggregated view of operations over a time window, partitioned by asset."
+openapi: "apis/fx-payment/openapi.yml GET /api/reports"
+---

apis/fx-account/openapi.yml

@@ -359,8 +359,18 @@ components:
           $ref: "#/components/schemas/RequirementsResponse"
         tags:
           type: array
+          description: >
+            System-managed labels attached to the account. Some tags
+            propagate to operations executed against this account.
           items:
             $ref: "#/components/schemas/TagResponse"
+          example:
+            - key: "psp"
+              value: "Amazon"
+            - key: null
+              value: "hidden"
+            - key: "compliance-tier"
+              value: "high"
         currentState:
           $ref: "#/components/schemas/AccountState"
         states:
@@ -1160,12 +1170,24 @@ components:
         - AX
     TagResponse:
       type: object
+      description: >
+        A label attached to a resource. Tags are system-managed — Trace
+        assigns them based on routing, compliance, and operational criteria.
+        Clients cannot create, modify, or remove tags via the API.
       properties:
         key:
           type: string
           nullable: true
+          description: >
+            Category for keyed tags (e.g., `psp`, `compliance-tier`).
+            `null` for single-value labels.
+          example: "psp"
         value:
           type: string
+          description: >
+            For keyed tags, the right-hand side of the label. For
+            single-value labels, the entire tag.
+          example: "Amazon"
       required:
         - value
     UBOResponse: