@celigo/api-specs 0.2.220 → 0.2.222

package/dist/editransaction.yml

@@ -149,8 +149,13 @@ paths:
 
         Use `fileType` with a dated window (`startDate`/`endDate`) to keep
         result sets bounded. `faStatus` must be passed as an array when
-        filtering. Unknown filter fields are silently ignored. To fetch the
-        raw EDI file for a returned record, use
+        filtering. Unknown filter fields are silently ignored. The dashboard's
+        `filters` object narrows server-side by document type, direction,
+        acknowledgement status, trading partner, lifecycle status, MDN status
+        and date range; `view: lifecycle` with `mode: browse` groups the
+        documents by order lifecycle (one collapsed row per group, newest
+        activity first) and `mode: expand` opens one group. To fetch the raw
+        EDI file for a returned record, use
         `POST /v1/jobs/{_flowJobId}/files/signedURL` with the record's
         `s3Key`.
       requestBody:
@@ -190,6 +195,34 @@ paths:
                   order: desc
                   limit: 100
                   startDate: 1742774400000
+              dashboard_filters:
+                summary: Server-side dashboard filters (dual-view response)
+                value:
+                  fileType: X12
+                  filters:
+                    lifecycleStatus:
+                      - Invoice received
+                    partner:
+                      - Acme Foods
+                    dateRange:
+                      from: '2026-11-01'
+                      to: '2026-11-03'
+              lifecycle_browse:
+                summary: Collapsed lifecycle groups, newest activity first
+                value:
+                  fileType: X12
+                  view: lifecycle
+                  mode: browse
+                  limit: 20
+                  filters: {}
+              lifecycle_expand:
+                summary: Every document of one lifecycle group
+                value:
+                  fileType: X12
+                  view: lifecycle
+                  mode: expand
+                  referenceDocumentNumber: PO P129-ORDER-0001
+                  partnerPairKey: 'ACMEFOODS      :CELIGOTEST     '
       responses:
         '200':
           description: |-
@@ -222,7 +255,7 @@ paths:
                         _integrationId: 66cc9b31f2be816bf9377036
                         _flowJobId: 6a05fe1675bab7047b42f047
                         fileType: X12
-                        documentType: '850'
+                        documentType: PO 850
                         documentNumber: PO03302026A
                         direction: Inbound
                         faStatus: inProgress
@@ -236,7 +269,13 @@ paths:
                           interchange: '000000005'
                           group: '1'
                           transactionSet: '0004'
+                        lifecycleStatus: PO received
+                        referenceDocumentNumber:
+                          - PO PO03302026A
+                        tradingPartnerName: Globex Retail
+                        partnerPairKey: '1234567890     :CELIGOLABZ     '
                         lastModified: '2026-05-14T16:53:44.624Z'
+                    totalCount: 1
                 edifact_record:
                   summary: EDIFACT ORDERS inbound
                   value:
@@ -258,6 +297,147 @@ paths:
                           unb: '1'
                           unh: '100001'
                         lastModified: '2026-05-14T16:52:19.677Z'
+                lifecycle_browse:
+                  summary: Lifecycle browse — one collapsed row per order
+                  value:
+                    view: lifecycle
+                    mode: browse
+                    groups:
+                      - groupKey:
+                          referenceDocumentNumber: PO P129-ORDER-0001
+                          partnerPairKey: 'ACMEFOODS      :CELIGOTEST     '
+                          fileType: X12
+                        hasChildren: true
+                        latestTransaction:
+                          _id: 6ae8902e8f6a1c2d3e4f5a6b
+                          fileType: X12
+                          _userId: 5e58483b68b52e5827d56a86
+                          sandbox: false
+                          s3Key: 4f0c2c1e8e9d4b7a9a1f3e5d7c9b2a10
+                          isaSenderId: 'ACMEFOODS      '
+                          isaReceiverId: 'CELIGOTEST     '
+                          gsSenderId: ACMEFOODS
+                          gsReceiverId: CELIGOTEST
+                          controlNumber:
+                            interchange: '000000305'
+                            group: '305'
+                            transactionSet: '0001'
+                          documentType: IN 810
+                          documentNumber: INV-P129-0001
+                          direction: Inbound
+                          faStatus: notApplicable
+                          lifecycleStatus: Invoice received
+                          referenceDocumentNumber:
+                            - PO P129-ORDER-0001
+                          tradingPartnerName: Acme Foods
+                          partnerPairKey: 'ACMEFOODS      :CELIGOTEST     '
+                          lastModified: '2026-11-02T13:29:28.376Z'
+                        relationshipMetadata:
+                          hasPurchaseOrderAnchor: true
+                      - groupKey:
+                          referenceDocumentNumber: null
+                          partnerPairKey: 'ACMEFOODS      :CELIGOTEST     '
+                          fileType: X12
+                        hasChildren: false
+                        latestTransaction:
+                          _id: 6ae88e49fbb635a43997e82d
+                          fileType: X12
+                          _userId: 5e58483b68b52e5827d56a86
+                          sandbox: false
+                          s3Key: 4f0c2c1e8e9d4b7a9a1f3e5d7c9b2a10
+                          isaSenderId: 'ACMEFOODS      '
+                          isaReceiverId: 'CELIGOTEST     '
+                          gsSenderId: ACMEFOODS
+                          gsReceiverId: CELIGOTEST
+                          controlNumber:
+                            interchange: '000000305'
+                            group: '305'
+                            transactionSet: '0001'
+                          documentType: PO 850
+                          direction: Inbound
+                          faStatus: notApplicable
+                          lifecycleStatus: PO received
+                          tradingPartnerName: Acme Foods
+                          partnerPairKey: 'ACMEFOODS      :CELIGOTEST     '
+                          lastModified: '2026-11-02T13:21:13.376Z'
+                        relationshipMetadata: null
+                lifecycle_expand:
+                  summary: Lifecycle expand — the newest document and the rest of the group
+                  value:
+                    view: lifecycle
+                    mode: expand
+                    group:
+                      latestTransaction:
+                        _id: 6ae8902e8f6a1c2d3e4f5a6b
+                        fileType: X12
+                        _userId: 5e58483b68b52e5827d56a86
+                        sandbox: false
+                        s3Key: 4f0c2c1e8e9d4b7a9a1f3e5d7c9b2a10
+                        isaSenderId: 'ACMEFOODS      '
+                        isaReceiverId: 'CELIGOTEST     '
+                        gsSenderId: ACMEFOODS
+                        gsReceiverId: CELIGOTEST
+                        controlNumber:
+                          interchange: '000000305'
+                          group: '305'
+                          transactionSet: '0001'
+                        documentType: IN 810
+                        documentNumber: INV-P129-0001
+                        direction: Inbound
+                        faStatus: notApplicable
+                        lifecycleStatus: Invoice received
+                        referenceDocumentNumber:
+                          - PO P129-ORDER-0001
+                        tradingPartnerName: Acme Foods
+                        partnerPairKey: 'ACMEFOODS      :CELIGOTEST     '
+                        lastModified: '2026-11-02T13:29:28.376Z'
+                      ediTransactions:
+                        - _id: 6ae88faf1e2d3c4b5a697889
+                          fileType: X12
+                          _userId: 5e58483b68b52e5827d56a86
+                          sandbox: false
+                          s3Key: 4f0c2c1e8e9d4b7a9a1f3e5d7c9b2a10
+                          isaSenderId: 'ACMEFOODS      '
+                          isaReceiverId: 'CELIGOTEST     '
+                          gsSenderId: ACMEFOODS
+                          gsReceiverId: CELIGOTEST
+                          controlNumber:
+                            interchange: '000000305'
+                            group: '305'
+                            transactionSet: '0001'
+                          documentType: SH 856
+                          documentNumber: ASN-P129-0001
+                          direction: Inbound
+                          faStatus: notApplicable
+                          lifecycleStatus: ASN received
+                          referenceDocumentNumber:
+                            - PO P129-ORDER-0001
+                          tradingPartnerName: Acme Foods
+                          partnerPairKey: 'ACMEFOODS      :CELIGOTEST     '
+                          lastModified: '2026-11-02T13:27:14.020Z'
+                        - _id: 6ae88f8a2b3c4d5e6f708192
+                          fileType: X12
+                          _userId: 5e58483b68b52e5827d56a86
+                          sandbox: false
+                          s3Key: 4f0c2c1e8e9d4b7a9a1f3e5d7c9b2a10
+                          isaSenderId: 'ACMEFOODS      '
+                          isaReceiverId: 'CELIGOTEST     '
+                          gsSenderId: ACMEFOODS
+                          gsReceiverId: CELIGOTEST
+                          controlNumber:
+                            interchange: '000000305'
+                            group: '305'
+                            transactionSet: '0001'
+                          documentType: PO 850
+                          documentNumber: P129-ORDER-0001
+                          direction: Inbound
+                          faStatus: notApplicable
+                          lifecycleStatus: PO received
+                          referenceDocumentNumber:
+                            - PO P129-ORDER-0001
+                          tradingPartnerName: Acme Foods
+                          partnerPairKey: 'ACMEFOODS      :CELIGOTEST     '
+                          lastModified: '2026-11-02T13:26:29.963Z'
         '400':
           description: The request body failed validation.
           content:
@@ -290,8 +470,255 @@ paths:
                     errors:
                       - code: invalid_sort_order
                         message: order must be asc or desc
+                invalid_lifecycle_browse_limit:
+                  value:
+                    errors:
+                      - code: invalid_lifecycle_browse_limit
+                        message: limit must be an integer between 1 and 50 for lifecycle browse
+                invalid_lifecycle_scan_batch_size:
+                  value:
+                    errors:
+                      - code: invalid_lifecycle_scan_batch_size
+                        message: scanBatchSize must be an integer between 1 and 1000 for lifecycle browse
+                invalid_lifecycle_expand_group_key:
+                  value:
+                    errors:
+                      - code: invalid_lifecycle_expand_group_key
+                        message: referenceDocumentNumber and partnerPairKey are required for lifecycle expand mode
+                invalid_query_views:
+                  value:
+                    errors:
+                      - code: invalid_query_views
+                        message: views must contain list and lifecycle
+                invalid_query_dual_page_token:
+                  value:
+                    errors:
+                      - code: invalid_query_dual_page_token
+                        message: dual query pageToken must contain list and lifecycle cursors
+                invalid_search_filters:
+                  summary: a filter dimension is malformed (here `direction` spelled as on the record, not lowercase)
+                  value:
+                    errors:
+                      - code: invalid_search_filters
+                        message: Invalid filters for field direction
+                invalid_fa_status:
+                  value:
+                    errors:
+                      - code: invalid_fa_status
+                        message: 'Invalid fa status, only accepted values: notReceived,accepted,acceptedWithErrors,rejected,failed,notApplicable'
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '404':
+          description: The lifecycle group named by an expand request does not exist in this environment.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+              examples:
+                lifecycle_group_not_found:
+                  value:
+                    errors:
+                      - code: lifecycle_group_not_found
+                        message: No accessible lifecycle group found for the given referenceDocumentNumber and partnerPairKey
+        '422':
+          description: The lifecycle view and mode fields contradict each other.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+              examples:
+                invalid_lifecycle_mode:
+                  value:
+                    errors:
+                      - code: invalid_lifecycle_mode
+                        message: mode must be browse or expand
+                invalid_query_view:
+                  summary: mode sent without view lifecycle
+                  value:
+                    errors:
+                      - code: invalid_query_view
+                        message: view must be lifecycle when mode is provided
+  /v1/ediTransactions/search:
+    post:
+      x-internal: false
+      operationId: searchEDITransactions
+      tags:
+        - EDI Transactions
+      summary: Search EDI transactions by keyword
+      description: |-
+        Searches one EDI standard's transactions for a keyword, optionally
+        narrowed by the B2B Manager dashboard filters. By default the response
+        carries a list window and a lifecycle window side by side, which is what
+        the dashboard renders; a lifecycle group that contains a match comes back
+        whole — its newest member as `latestTransaction` and every other member
+        in `ediTransactions`, matched or not, each matched row naming the fields
+        it matched in `matchedFields`.
+
+        X12 `documentType` values come back labeled with the functional group
+        code, for example `PO 850`. Requires a B2B / EDI license and permission to
+        read EDI transactions.
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/EDITransactionsSearchRequest'
+            examples:
+              dual_default:
+                summary: Search X12 transactions in both views
+                value:
+                  keyword: PO03302026A
+                  source: X12
+              list_rejected:
+                summary: List view, rejected only, newest first
+                value:
+                  keyword: Globex
+                  source: X12
+                  viewMode: list
+                  pageSize: 50
+                  sortBy: lastModified
+                  order: desc
+                  filters:
+                    faStatus:
+                      - rejected
+      responses:
+        '200':
+          description: |-
+            One page of matches. `ediTransactions` is an empty array (or empty
+            windows) when nothing matches.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/EDITransactionsSearchResponse'
+        '400':
+          description: The request body failed validation.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+              examples:
+                keyword_required:
+                  value:
+                    errors:
+                      - code: keyword_required
+                        message: keyword is required for search
+                keyword_too_short:
+                  value:
+                    errors:
+                      - code: keyword_too_short
+                        message: keyword must be at least 3 characters
+                keyword_too_long:
+                  value:
+                    errors:
+                      - code: keyword_too_long
+                        message: keyword must not exceed 100 characters
+                invalid_keyword:
+                  summary: keyword contains control characters
+                  value:
+                    errors:
+                      - code: invalid_keyword
+                        message: keyword contains invalid characters
+                invalid_source:
+                  value:
+                    errors:
+                      - code: invalid_source
+                        message: source must be X12 or EDIFACT
+                invalid_view_mode:
+                  value:
+                    errors:
+                      - code: invalid_view_mode
+                        message: viewMode must be list, lifecycle, or dual
+                invalid_page_size:
+                  value:
+                    errors:
+                      - code: invalid_page_size
+                        message: pageSize must be an integer between 1 and 100
+                invalid_page_token:
+                  value:
+                    errors:
+                      - code: invalid_page_token
+                        message: pageToken is invalid or malformed
+                invalid_search_filters:
+                  value:
+                    errors:
+                      - code: invalid_search_filters
+                        message: Invalid filters for field faStatus
+                invalid_fa_status:
+                  summary: filters.faStatus holds an unknown value
+                  value:
+                    errors:
+                      - code: invalid_fa_status
+                        message: 'Invalid fa status, only accepted values: notReceived,accepted,acceptedWithErrors,rejected,failed,notApplicable,inProgress'
+                invalid_filter_lifecycle_status:
+                  summary: filters.lifecycleStatus holds an unknown value (message shortened)
+                  value:
+                    errors:
+                      - code: invalid_filter_lifecycle_status
+                        message: 'Invalid lifecycleStatus filter. Accepted values: PO received, PO sent, PO Ack received, PO Ack sent, …'
+                invalid_date_range:
+                  summary: filters.dateRange is malformed or reversed
+                  value:
+                    errors:
+                      - code: invalid_date_range
+                        message: please provide a valid date range
+                invalid_search_columns:
+                  value:
+                    errors:
+                      - code: invalid_search_columns
+                        message: Invalid columns for field visibleColumns.list
+                invalid_sandbox:
+                  value:
+                    errors:
+                      - code: invalid_sandbox
+                        message: sandbox must be a boolean
+                unsupported_sort_field:
+                  value:
+                    errors:
+                      - code: unsupported_sort_field
+                        message: 'sortBy must be one of: relevance, lastModified, tradingPartnerName'
+                invalid_sort_order:
+                  value:
+                    errors:
+                      - code: invalid_sort_order
+                        message: order must be asc or desc
+                sort_not_supported_for_lifecycle:
+                  value:
+                    errors:
+                      - code: sort_not_supported_for_lifecycle
+                        message: Lifecycle view supports only the default sort (sortBy=lastModified, order=desc)
         '401':
           $ref: '#/components/responses/401-unauthorized'
+        '408':
+          description: The search took too long.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+              examples:
+                search_timeout:
+                  value:
+                    errors:
+                      - code: search_timeout
+                        message: search request timed out
+        '503':
+          description: |-
+            Search, or the requested sort, is temporarily unavailable. For the
+            sort codes, retry without `sortBy` and `order`.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+              examples:
+                search_unavailable:
+                  value:
+                    errors:
+                      - code: search_unavailable
+                        message: Atlas Search is temporarily unavailable
+                sort_disabled:
+                  value:
+                    errors:
+                      - code: sort_disabled
+                        message: Sorting is temporarily unavailable. Retry without sortBy and order to use the default sort.
   /v1/ediTransactions/download:
     post:
       x-internal: false
@@ -1475,14 +1902,17 @@ components:
         documentType:
           type: string
           description: |-
-            EDI document type. X12: usually the numeric transaction-set ID as a
-            string (`"850"`, `"810"`, `"856"`, `"997"`). EDIFACT: UNH01 message
-            type (`"ORDERS"`, `"INVOIC"`, `"DESADV"`, `"CONTRL"`). Not a closed
-            set — file definitions can supply partner-specific document codes
-            instead (e.g. `"PO"`, `"SH"`, `"IB"`, `"OSTRPT"`), so treat this as a
-            free-form label.
+            EDI document type. X12: the transaction-set ID labeled with its GS01
+            functional-group code — `"PO 850"`, `"IN 810"`, `"SH 856"`, `"PR 855"`
+            — on every read path (`/query`, `/search`, lifecycle browse and
+            expand, `/filter-options`, the download CSV); `filters.documentType`
+            accepts the labeled form or the bare code. EDIFACT:
+            the UNH01 message type (`"ORDERS"`, `"INVOIC"`, `"DESADV"`,
+            `"CONTRL"`). Not a closed set — file definitions can supply
+            partner-specific document codes instead (e.g. `"PO"`, `"SH"`,
+            `"IB"`, `"OSTRPT"`), so treat this as a free-form label.
           examples:
-            - '850'
+            - PO 850
         documentNumber:
           type: string
           description: |-
@@ -1555,10 +1985,23 @@ components:
             Upper-cased key identifying the trading-partner pair that exchanged
             the document, shared by every document of that pair so an order
             lifecycle can be followed across documents together with
-            `referenceDocumentNumber`. Present only when the flow resolved the
-            partner.
+            `referenceDocumentNumber`. The two interchange ids keep the padding
+            they were stored with (fixed-width ISA fields keep their trailing
+            spaces); pass the key back exactly as returned when expanding a
+            lifecycle group. Present only when the flow resolved the partner.
+          examples:
+            - 'ACMEFOODS      :CELIGOTEST     '
+        matchedFields:
+          type: array
+          items:
+            type: string
+          description: |-
+            Record fields the keyword matched, as field paths
+            (`referenceDocumentNumber`, `controlNumber.interchange`, …). Present
+            only on rows returned by `POST /v1/ediTransactions/search`.
           examples:
-            - ACME:GLOBEX
+            - - documentNumber
+              - referenceDocumentNumber
         direction:
           type: string
           enum:
@@ -1767,62 +2210,190 @@ components:
               - message
       required:
         - errors
-    EDITransactionsQueryRequest:
+    EDIDashboardDirection:
+      type: string
+      enum:
+        - inbound
+        - outbound
+      x-enumDescriptions:
+        inbound: Documents received from a trading partner.
+        outbound: Documents sent to a trading partner.
+      description: Transaction direction as the dashboard filters spell it.
+    EDIDashboardFAStatus:
+      type: string
+      enum:
+        - inProgress
+        - notApplicable
+        - notReceived
+        - accepted
+        - acceptedWithErrors
+        - rejected
+        - failed
+      x-enumDescriptions:
+        inProgress: Awaiting functional acknowledgment from the trading partner.
+        notApplicable: No functional acknowledgment expected.
+        notReceived: Functional acknowledgment expected but not yet received.
+        accepted: Functional acknowledgment received and the transaction was accepted.
+        acceptedWithErrors: Functional acknowledgment received with errors, but the transaction was accepted.
+        rejected: Functional acknowledgment received and the transaction was rejected.
+        failed: Functional acknowledgment processing failed.
+      description: Functional acknowledgment status of a transaction.
+    EDIDashboardMDNStatus:
+      type: string
+      enum:
+        - sent
+        - received
+      x-enumDescriptions:
+        sent: An AS2 MDN was sent for the document.
+        received: An AS2 MDN was received for the document.
+      description: AS2 MDN status of a transaction.
+    EDIDashboardFilters:
       type: object
       description: |-
-        Filter for `POST /v1/ediTransactions/query`. All fields are optional.
-        Results are narrowed by `fileType`, `interchangeSenderId`,
-        `interchangeReceiverId`, `documentNumber`, `faStatus`, and the
-        `startDate`/`endDate` window. `direction`, `documentType`, and
-        `_integrationId` are accepted but not applied server-side (filter on those
-        client-side). Records come back newest-first by `lastModified` unless
-        `sortBy` or `order` is set, and are cursor-paginated via `pageToken`.
+        B2B Manager dashboard filter dimensions. An empty object, or one whose
+        arrays are all empty, applies no filter.
       properties:
-        fileType:
-          type: string
-          enum:
-            - X12
-            - EDIFACT
-          x-enumDescriptions:
-            X12: ANSI X12 EDI standard.
-            EDIFACT: UN/EDIFACT EDI standard.
-          description: |-
-            EDI standard family. Defaults to `X12` when omitted — set
-            `fileType: EDIFACT` explicitly to query EDIFACT records.
-        interchangeSenderId:
-          type: string
-          description: |-
-            Filter by interchange sender ID — exact match against the record's
-            `isaSenderId` (X12 ISA06). Applied server-side.
-          examples:
-            - '1234567890'
-        interchangeReceiverId:
-          type: string
+        documentType:
+          type: array
+          items:
+            type: string
           description: |-
-            Filter by interchange receiver ID — exact match against the record's
-            `isaReceiverId` (X12 ISA08). Applied server-side.
+            Document types to match, as the X12 transaction-set code or the
+            EDIFACT message type (`850`, `ORDERS`). An X12 code labeled with its
+            functional group (`PO 850`) is read as the bare code.
           examples:
-            - CELIGOLABZ
+            - - '850'
+              - PO 810
         direction:
-          type: string
-          enum:
-            - Inbound
-            - Outbound
-          x-enumDescriptions:
-            Inbound: Document received from a trading partner.
-            Outbound: Document sent to a trading partner.
-          description: |-
-            Transaction direction. Accepted by the endpoint but not applied as a
-            server-side filter — the result set is unaffected; filter client-side.
-        documentType:
-          type: string
+          type: array
+          items:
+            $ref: '#/components/schemas/EDIDashboardDirection'
           description: |-
-            EDI document type code. For X12 this is the numeric transaction-set ID
-            as a string (e.g. `"850"`, `"810"`, `"856"`, `"997"`); for EDIFACT the
-            UNH01 message type (e.g. `"ORDERS"`, `"INVOIC"`, `"DESADV"`, `"CONTRL"`).
-            Accepted but not applied as a server-side filter — the result set is
-            unaffected; filter client-side.
-          examples:
+            Directions to match. Lowercase here, unlike the capitalized
+            `direction` values on the returned records.
+        faStatus:
+          type: array
+          items:
+            $ref: '#/components/schemas/EDIDashboardFAStatus'
+          description: Functional acknowledgment statuses to match.
+        partner:
+          type: array
+          items:
+            type: string
+          description: |-
+            Trading partner names to match against each record's
+            `tradingPartnerName`. Use the values `GET /v1/ediTransactions/filter-options`
+            returns in `partner`.
+          examples:
+            - - Globex Retail
+        lifecycleStatus:
+          type: array
+          items:
+            type: string
+          description: |-
+            Order-lifecycle steps to match against each record's
+            `lifecycleStatus`. Takes the values
+            `GET /v1/ediTransactions/filter-options` returns in `lifecycleStatus`;
+            anything else is rejected.
+          examples:
+            - - PO received
+              - Invoice sent
+        mdnStatus:
+          type: array
+          items:
+            $ref: '#/components/schemas/EDIDashboardMDNStatus'
+          description: AS2 MDN statuses to match.
+        dateRange:
+          type: object
+          required:
+            - from
+            - to
+          description: Window on each record's `lastModified`.
+          properties:
+            from:
+              type: string
+              format: date
+              description: First day of the window.
+              examples:
+                - '2026-10-01'
+            to:
+              type: string
+              format: date
+              description: Last day of the window. Can equal `from`; a `to` before `from` is rejected.
+              examples:
+                - '2026-10-22'
+            fromTime:
+              type: string
+              pattern: ^([01]\d|2[0-3]):[0-5]\d:[0-5]\d$
+              description: Start time on the `from` day, so the window can begin mid-day.
+              examples:
+                - '08:30:00'
+            toTime:
+              type: string
+              pattern: ^([01]\d|2[0-3]):[0-5]\d:[0-5]\d$
+              description: End time on the `to` day, so the window can end mid-day.
+              examples:
+                - '17:45:00'
+    EDITransactionsQueryRequest:
+      type: object
+      description: |-
+        Filter for `POST /v1/ediTransactions/query`. All fields are optional.
+        Results are narrowed by `fileType`, `interchangeSenderId`,
+        `interchangeReceiverId`, `documentNumber`, `faStatus`, the
+        `startDate`/`endDate` window, and the dashboard's `filters` object, which
+        the server applies in full. The top-level `direction`, `documentType`, and
+        `_integrationId` are accepted but not applied server-side (filter on those
+        client-side, or use `filters`). Records come back newest-first by
+        `lastModified` unless `sortBy` or `order` is set, and are cursor-paginated
+        via `pageToken`. `view: lifecycle` with `mode` returns the documents
+        grouped by order lifecycle instead of flat rows.
+      properties:
+        fileType:
+          type: string
+          enum:
+            - X12
+            - EDIFACT
+          x-enumDescriptions:
+            X12: ANSI X12 EDI standard.
+            EDIFACT: UN/EDIFACT EDI standard.
+          description: |-
+            EDI standard family. Defaults to `X12` when omitted — set
+            `fileType: EDIFACT` explicitly to query EDIFACT records.
+        interchangeSenderId:
+          type: string
+          description: |-
+            Filter by interchange sender ID — exact match against the record's
+            `isaSenderId` (X12 ISA06). Applied server-side.
+          examples:
+            - '1234567890'
+        interchangeReceiverId:
+          type: string
+          description: |-
+            Filter by interchange receiver ID — exact match against the record's
+            `isaReceiverId` (X12 ISA08). Applied server-side.
+          examples:
+            - CELIGOLABZ
+        direction:
+          type: string
+          enum:
+            - Inbound
+            - Outbound
+          x-enumDescriptions:
+            Inbound: Document received from a trading partner.
+            Outbound: Document sent to a trading partner.
+          description: |-
+            Transaction direction. Accepted by the endpoint but not applied as a
+            server-side filter — the result set is unaffected; filter client-side.
+        documentType:
+          type: string
+          description: |-
+            EDI document type code. For X12 this is the numeric transaction-set ID
+            as a string (e.g. `"850"`, `"810"`, `"856"`, `"997"`); for EDIFACT the
+            UNH01 message type (e.g. `"ORDERS"`, `"INVOIC"`, `"DESADV"`, `"CONTRL"`).
+            Accepted but not applied as a server-side filter — the result set is
+            unaffected; use `filters.documentType` for a server-side match, or
+            filter client-side.
+          examples:
             - '850'
         documentNumber:
           type: string
@@ -1872,7 +2443,11 @@ components:
           description: |-
             Lower bound of the `lastModified` window, as epoch milliseconds.
             The CLI converts ISO-8601 date strings to epoch-ms before calling.
-            When omitted, the server applies an internal default window.
+            When omitted on a request that carries no `filters` key, the server
+            applies its legacy default window of the last 24 hours. The presence
+            of `filters` — an empty object included — lifts that window, so the
+            whole history is read newest-first; a non-empty `filters` object
+            additionally answers in the dual-view shape (see `filters`).
           examples:
             - 1742774400000
         endDate:
@@ -1884,22 +2459,147 @@ components:
           examples:
             - 1745452800000
         limit:
-          type: integer
+          type:
+            - integer
+            - object
           minimum: 1
           maximum: 1000
           description: |-
-            Maximum number of records to return per page. Server-enforced
-            range is 1–1000.
-            When more records exist beyond the limit, the response includes a
+            Page size. An integer on a flat request (records per page,
+            1–1000) and on a lifecycle browse (groups per page, 1–50, default
+            20 — `invalid_lifecycle_browse_limit` otherwise); expand ignores it.
+            On a dual-view request (`views`, or a non-empty `filters`) an object
+            sizing each window — an integer is ignored there, and an object on
+            any other request fails with `invalid_limit_value`. When more
+            records exist beyond the limit, the response includes a
             `pageToken.next` cursor for the next page.
+          properties:
+            list:
+              type: integer
+              minimum: 1
+              maximum: 1000
+              description: Rows in the list window, default 50. Out of range fails with `invalid_limit_value`.
+            lifecycle:
+              type: integer
+              minimum: 1
+              maximum: 50
+              description: Groups in the lifecycle window, default 20. Above 50 fails with `invalid_lifecycle_browse_limit`.
           examples:
             - 100
         pageToken:
-          type: string
+          type:
+            - string
+            - object
           description: |-
             Opaque cursor from a previous response's `pageToken.next`. Pass
-            this value to retrieve the next page of results. Omit on the
-            first call.
+            this value to retrieve the next page of results; omit it on the
+            first call. On a dual-view request send an object carrying both
+            windows' cursors — one missing either key fails with
+            `invalid_query_dual_page_token`. A cursor fixes its own sort, so
+            `sortBy` and `order` are ignored beside it.
+          required:
+            - list
+            - lifecycle
+          properties:
+            list:
+              type:
+                - string
+                - 'null'
+              description: The list window's `pageToken.next`, or null once that window is exhausted.
+            lifecycle:
+              type:
+                - string
+                - 'null'
+              description: The lifecycle window's `pageToken.next`, or null once that window is exhausted.
+        filters:
+          $ref: '#/components/schemas/EDIDashboardFilters'
+          description: |-
+            Dashboard filters. The presence of this key, even as `{}`, lifts the
+            24-hour default window on `startDate`, so set `dateRange` (or
+            `startDate`) to keep the result set bounded. Any non-empty object,
+            even one holding only unknown keys, also returns both views on every
+            page, as `views` does. A malformed dimension or a `documentType`
+            that is not a document type of `fileType` fails with
+            `invalid_search_filters`, an unknown `faStatus` with
+            `invalid_fa_status`, an unknown `lifecycleStatus` with
+            `invalid_filter_lifecycle_status`, and a malformed or reversed
+            `dateRange` with `invalid_date_range`.
+        views:
+          type: array
+          minItems: 2
+          maxItems: 2
+          uniqueItems: true
+          items:
+            type: string
+            enum:
+              - list
+              - lifecycle
+            x-enumDescriptions:
+              list: Flat transaction rows.
+              lifecycle: Collapsed lifecycle groups.
+          description: |-
+            Asks the first unfiltered page for both views at once, in which case
+            `ediTransactions` comes back as an object holding a `list` and a
+            `lifecycle` window. Must contain both values
+            (`invalid_query_views` otherwise). Omit it on later unfiltered pages.
+            A request with non-empty `filters` returns both views on every page
+            without it. A dual-view request takes `limit` and `pageToken` as
+            objects.
+          examples:
+            - - list
+              - lifecycle
+        view:
+          type: string
+          enum:
+            - list
+            - lifecycle
+          x-enumDescriptions:
+            list: Flat transaction rows — the same result as omitting the field.
+            lifecycle: Group documents by order lifecycle instead of returning flat rows.
+          description: |-
+            Set to `lifecycle`, together with `mode`, to get grouped results. Omit
+            it, or send `list`, for the flat list.
+        mode:
+          type: string
+          enum:
+            - browse
+            - expand
+          x-enumDescriptions:
+            browse: Return one collapsed row per lifecycle group in `groups`.
+            expand: Return every member of the group named by `referenceDocumentNumber` and `partnerPairKey` in `group`.
+          description: |-
+            Lifecycle mode; required with `view: lifecycle`. Any other value fails
+            with 422 `invalid_lifecycle_mode`, and `mode` without
+            `view: lifecycle` fails with 422 `invalid_query_view`. For expand,
+            send the same `sandbox` value as the browse request, because a group
+            from the other environment returns 404 `lifecycle_group_not_found`.
+        referenceDocumentNumber:
+          type: string
+          description: |-
+            Expand only. The `groupKey.referenceDocumentNumber` of the browse
+            group to load. Required with `mode: expand`, together with
+            `partnerPairKey` (`invalid_lifecycle_expand_group_key` otherwise).
+          examples:
+            - PO 6P31195
+        partnerPairKey:
+          type: string
+          description: |-
+            Expand only. The `groupKey.partnerPairKey` of the browse group to
+            load, exactly as returned — the interchange ids keep their stored
+            padding and a trimmed key answers 404 `lifecycle_group_not_found`.
+            Required with `mode: expand`.
+          examples:
+            - 'ACMEFOODS      :CELIGOTEST     '
+        scanBatchSize:
+          type: integer
+          minimum: 1
+          maximum: 1000
+          default: 100
+          description: |-
+            Lifecycle browse only. Transactions read per batch while collecting
+            distinct groups. Raise it when a page of groups comes back short
+            because many recent documents share a few groups. Out of range fails
+            with `invalid_lifecycle_scan_batch_size`.
         sortBy:
           type: string
           enum:
@@ -1923,6 +2623,137 @@ components:
             Sort direction. Defaults to `desc` for `lastModified` and `asc` for
             `tradingPartnerName`. Sending `order` alone sorts by `lastModified`.
             Any other value fails with `invalid_sort_order`.
+    EDITransactionsQueryListWindow:
+      type: object
+      required:
+        - ediTransactions
+      description: The list window of a dual-view page.
+      properties:
+        ediTransactions:
+          type: array
+          description: Matching EDI transaction records for this window.
+          items:
+            $ref: '#/components/schemas/EDITransaction'
+        totalCount:
+          type:
+            - integer
+            - 'null'
+          description: Number of matching records. First page only; capped when `isApproximate` is true, null when the count timed out.
+        isApproximate:
+          type: boolean
+          description: When true, `totalCount` hit its cap or timed out.
+        pageToken:
+          type: object
+          description: Present only when more rows exist in this window.
+          properties:
+            next:
+              type: string
+              description: Pass back as `pageToken.list` on the next dual-view request.
+    EDILifecycleGroupKey:
+      type: object
+      description: |-
+        Identifies one order lifecycle: the documents a trading-partner pair
+        exchanged about one reference document. Pass `referenceDocumentNumber`
+        and `partnerPairKey` back to `POST /v1/ediTransactions/query` with
+        `view: lifecycle` and `mode: expand` to load every member.
+      properties:
+        referenceDocumentNumber:
+          type:
+            - string
+            - 'null'
+          description: |-
+            Prefixed reference the group is anchored on (for example
+            `PO 6P31195`). Null for a standalone document with no extractable
+            reference.
+          examples:
+            - PO 6P31195
+        partnerPairKey:
+          type:
+            - string
+            - 'null'
+          description: |-
+            Trading-partner pair the group belongs to, with the interchange ids
+            padded as stored. Pass it back exactly as returned — a trimmed key
+            names no group (404 `lifecycle_group_not_found`). Null when the flow
+            did not resolve the partner.
+          examples:
+            - 'ACMEFOODS      :CELIGOTEST     '
+        fileType:
+          type: string
+          enum:
+            - X12
+            - EDIFACT
+          x-enumDescriptions:
+            X12: ANSI X12 EDI standard.
+            EDIFACT: UN/EDIFACT EDI standard.
+          description: EDI standard family of the group's documents.
+    EDIRelationshipMetadata:
+      type:
+        - object
+        - 'null'
+      description: |-
+        Facts about the documents in a lifecycle group. An object when the group
+        has a reference document number; null for a group anchored on a document
+        with no extractable reference. Omitted on expand responses.
+      properties:
+        hasPurchaseOrderAnchor:
+          type: boolean
+          description: |-
+            When true, the group contains the purchase order itself (an X12 850
+            or an EDIFACT ORDERS), not only downstream documents such as invoices
+            or ship notices. Acknowledgements and change requests (855, 860, 865,
+            ORDRSP, ORDCHG) do not count as an anchor.
+    EDILifecycleBrowseGroup:
+      type: object
+      required:
+        - groupKey
+        - hasChildren
+        - latestTransaction
+      description: One collapsed lifecycle group on a lifecycle browse page.
+      properties:
+        groupKey:
+          $ref: '#/components/schemas/EDILifecycleGroupKey'
+        hasChildren:
+          type: boolean
+          description: When true, the group has two or more members and can be expanded.
+        latestTransaction:
+          $ref: '#/components/schemas/EDITransaction'
+        relationshipMetadata:
+          $ref: '#/components/schemas/EDIRelationshipMetadata'
+    EDILifecycleBrowsePage:
+      type: object
+      required:
+        - view
+        - mode
+        - groups
+      description: One page of collapsed lifecycle groups, newest activity first.
+      properties:
+        view:
+          type: string
+          enum:
+            - lifecycle
+          x-enumDescriptions:
+            lifecycle: Grouped lifecycle results.
+          description: Echoes the requested view.
+        mode:
+          type: string
+          enum:
+            - browse
+          x-enumDescriptions:
+            browse: Collapsed groups, one row per lifecycle.
+          description: Echoes the requested lifecycle mode.
+        groups:
+          type: array
+          description: Lifecycle groups on this page.
+          items:
+            $ref: '#/components/schemas/EDILifecycleBrowseGroup'
+        pageToken:
+          type: object
+          description: Present only when more groups exist beyond this page.
+          properties:
+            next:
+              type: string
+              description: Forward-only cursor. Pass it back as `pageToken` to get the next page of groups.
     EDITransactionsQuerySort:
       type: object
       required:
@@ -1948,21 +2779,70 @@ components:
             asc: Ascending.
             desc: Descending.
           description: Sort direction applied, including the default when the request set only `sortBy`.
+    EDILifecycleExpandGroup:
+      type: object
+      required:
+        - latestTransaction
+        - ediTransactions
+      description: |-
+        One lifecycle group opened: its newest member as the parent row and the
+        other members beneath it.
+      properties:
+        latestTransaction:
+          $ref: '#/components/schemas/EDITransaction'
+        ediTransactions:
+          type: array
+          maxItems: 50
+          description: |-
+            The group's other members, newest first — `latestTransaction` is not
+            repeated, so a one-document group returns an empty array. Only the
+            newest 50 are returned; check `truncated` to learn whether older
+            members exist.
+          items:
+            $ref: '#/components/schemas/EDITransaction'
+        truncated:
+          type: boolean
+          description: Present and true when the group has more than 50 other members.
     EDITransactionsQueryResponse:
       type: object
       description: |-
         One page of EDI transaction records matching the request filter. When
         more records exist beyond the `limit`, `pageToken.next` contains an
-        opaque cursor to pass back on the next request for the next page.
+        opaque cursor to pass back on the next request for the next page. A
+        lifecycle request (`view: lifecycle`) answers with `view`, `mode` and
+        `groups` or `group` instead of `ediTransactions`.
       properties:
         ediTransactions:
-          type: array
+          type:
+            - array
+            - object
           description: |-
             Matching EDI transaction records, newest first by `lastModified`
             unless the request sets `sortBy` or `order`. Empty array when no
             records match — the endpoint does not switch to 204 for empty results.
+            On a dual-view page (`views` sent, or a non-empty `filters`) an object
+            holding the `list` and `lifecycle` windows side by side instead.
           items:
             $ref: '#/components/schemas/EDITransaction'
+          required:
+            - list
+            - lifecycle
+          properties:
+            list:
+              $ref: '#/components/schemas/EDITransactionsQueryListWindow'
+            lifecycle:
+              $ref: '#/components/schemas/EDILifecycleBrowsePage'
+        totalCount:
+          type:
+            - integer
+            - 'null'
+          description: |-
+            Number of matching records. Present on the first page of a flat
+            list request only. Capped when `isApproximate` is true; null when
+            the count timed out.
+        isApproximate:
+          type: boolean
+          description: When true, `totalCount` hit its cap or timed out. Omitted when the count is exact.
         pageToken:
           type: object
           description: |-
@@ -1976,130 +2856,420 @@ components:
                 body to retrieve the next page.
         sort:
           $ref: '#/components/schemas/EDITransactionsQuerySort'
-    EDIDashboardDirection:
-      type: string
-      enum:
-        - inbound
-        - outbound
-      x-enumDescriptions:
-        inbound: Documents received from a trading partner.
-        outbound: Documents sent to a trading partner.
-      description: Transaction direction as the dashboard filters spell it.
-    EDIDashboardFAStatus:
-      type: string
-      enum:
-        - inProgress
-        - notApplicable
-        - notReceived
-        - accepted
-        - acceptedWithErrors
-        - rejected
-        - failed
-      x-enumDescriptions:
-        inProgress: Awaiting functional acknowledgment from the trading partner.
-        notApplicable: No functional acknowledgment expected.
-        notReceived: Functional acknowledgment expected but not yet received.
-        accepted: Functional acknowledgment received and the transaction was accepted.
-        acceptedWithErrors: Functional acknowledgment received with errors, but the transaction was accepted.
-        rejected: Functional acknowledgment received and the transaction was rejected.
-        failed: Functional acknowledgment processing failed.
-      description: Functional acknowledgment status of a transaction.
-    EDIDashboardMDNStatus:
-      type: string
-      enum:
-        - sent
-        - received
-      x-enumDescriptions:
-        sent: An AS2 MDN was sent for the document.
-        received: An AS2 MDN was received for the document.
-      description: AS2 MDN status of a transaction.
-    EDIDashboardFilters:
+        view:
+          type: string
+          enum:
+            - lifecycle
+          x-enumDescriptions:
+            lifecycle: Grouped lifecycle results.
+          description: |-
+            Present only on lifecycle responses (`view: lifecycle`), which carry
+            `view`, `mode`, and `groups` or `group` instead of `ediTransactions`.
+        mode:
+          type: string
+          enum:
+            - browse
+            - expand
+          x-enumDescriptions:
+            browse: The page carries collapsed groups in `groups`.
+            expand: The page carries one group's members in `group`.
+          description: Present only on lifecycle responses; says whether `groups` or `group` is set.
+        groups:
+          type: array
+          description: Present when `mode` is `browse`. Collapsed lifecycle groups, newest activity first.
+          items:
+            $ref: '#/components/schemas/EDILifecycleBrowseGroup'
+        group:
+          $ref: '#/components/schemas/EDILifecycleExpandGroup'
+    EDITransactionsSearchRequest:
       type: object
+      required:
+        - keyword
+        - source
       description: |-
-        B2B Manager dashboard filter dimensions. An empty object, or one whose
-        arrays are all empty, applies no filter.
+        Keyword search over one EDI standard's transactions, optionally narrowed by
+        the dashboard filters. To continue a result set, send the same body with
+        the previous response's `pageToken.next`. In `filters`, a malformed
+        dimension or a `documentType` that is not a document type of `source`
+        fails with `invalid_search_filters`, an unknown `faStatus` with
+        `invalid_fa_status`, an unknown `lifecycleStatus` with
+        `invalid_filter_lifecycle_status`, and a malformed or reversed
+        `dateRange` with `invalid_date_range`; unknown filter keys are ignored.
       properties:
-        documentType:
-          type: array
-          items:
-            type: string
+        keyword:
+          type: string
+          minLength: 3
+          maxLength: 100
           description: |-
-            Document types to match, as the X12 transaction-set code or the
-            EDIFACT message type (`850`, `ORDERS`). An X12 code labeled with its
-            functional group (`PO 850`) is read as the bare code.
+            Text matched against the transaction's document number, reference
+            document numbers, interchange and group sender / receiver ids and
+            control numbers, case-insensitively after trimming; each row names
+            the fields it matched in `matchedFields`. A keyword of 3–12
+            characters matches anywhere inside a value (`ORDER-0001` finds
+            `P129-ORDER-0001`); 13 characters or more must equal a whole stored
+            value (`P129-ORDER-0001`, or `PO P129-ORDER-0001` with its qualifier
+            for a reference). The trading partner name and the lifecycle status
+            are not searched — narrow those with `filters`. Shorter fails with
+            `keyword_too_short`, longer with `keyword_too_long`, and control
+            characters with `invalid_keyword`.
           examples:
-            - - '850'
-              - PO 810
-        direction:
+            - PO03302026A
+        source:
+          type: string
+          enum:
+            - X12
+            - EDIFACT
+          x-enumDescriptions:
+            X12: Search ANSI X12 transactions.
+            EDIFACT: Search UN/EDIFACT transactions.
+          description: EDI standard to search. Anything else fails with `invalid_source`.
+        viewMode:
+          type: string
+          enum:
+            - dual
+            - list
+            - lifecycle
+          default: dual
+          x-enumDescriptions:
+            dual: Return a list window and a lifecycle window side by side in `ediTransactions.list` and `ediTransactions.lifecycle`.
+            list: Return flat matching rows in `ediTransactions`.
+            lifecycle: Return the lifecycle groups that contain a match in `ediTransactions`.
+          description: |-
+            Shape of the result. The dashboard uses the default, `dual`. Any other
+            value fails with `invalid_view_mode`.
+        pageSize:
+          type: integer
+          minimum: 1
+          maximum: 100
+          description: |-
+            Results per page. On a `dual` request it sizes both windows. Defaults
+            to 50 list rows and 20 lifecycle groups. Out-of-range values, and an
+            object such as `{list, lifecycle}`, fail with `invalid_page_size`.
+          examples:
+            - 50
+        pageToken:
+          type:
+            - string
+            - object
+          description: |-
+            Cursor from a previous response's `pageToken.next`. It fixes its own
+            page size, view, and sort, so `sortBy` and `order` are ignored when
+            it is present. A tampered or stale token fails with
+            `invalid_page_token`. To continue a `dual` result set, send an object
+            with each window's cursor; an empty object starts from the first page.
+            `list` and `lifecycle` requests take only the string form.
+          properties:
+            list:
+              type:
+                - string
+                - 'null'
+              description: The list window's `pageToken.next`. Omit it or send null once that window is exhausted.
+            lifecycle:
+              type:
+                - string
+                - 'null'
+              description: The lifecycle window's `pageToken.next`. Omit it or send null once that window is exhausted.
+        sandbox:
+          type: boolean
+          default: false
+          description: |-
+            When true, searches sandbox transactions instead of production ones.
+            A non-boolean fails with `invalid_sandbox`.
+        filters:
+          $ref: '#/components/schemas/EDIDashboardFilters'
+        visibleColumns:
+          type: object
+          description: |-
+            Columns the caller currently shows, per view. Fields that matched the
+            keyword but are not listed come back in `matchedHiddenColumns`, so the
+            UI can tell the user why a row matched. Set at least one non-empty
+            array of known field names (`invalid_search_columns` otherwise).
+          properties:
+            list:
+              type: array
+              items:
+                type: string
+              description: Field names shown in the list view.
+              examples:
+                - - documentNumber
+                  - tradingPartnerName
+                  - lastModified
+            lifecycle:
+              type: array
+              items:
+                type: string
+              description: Field names shown in the lifecycle view.
+        sortBy:
+          type: string
+          enum:
+            - relevance
+            - lastModified
+            - tradingPartnerName
+          default: relevance
+          x-enumDescriptions:
+            relevance: Best match first.
+            lastModified: Sort by last activity.
+            tradingPartnerName: Sort by trading partner name in byte order; rows without a partner come first ascending and last descending.
+          description: |-
+            Sort for the list window. Any other value fails with
+            `unsupported_sort_field`. `viewMode: lifecycle` accepts only
+            `relevance` or `lastModified` descending
+            (`sort_not_supported_for_lifecycle`). A sort other than `relevance`
+            can fail with 503 `sort_disabled`, `sort_index_not_ready`, or
+            `query_sort_timeout`; retry without `sortBy` and `order`.
+        order:
+          type: string
+          enum:
+            - asc
+            - desc
+          x-enumDescriptions:
+            asc: Ascending.
+            desc: Descending.
+          description: |-
+            Sort direction. Defaults to `desc` for `relevance` and `lastModified`
+            and `asc` for `tradingPartnerName`; `relevance` accepts only `desc`.
+            Sending `order` alone sorts by `lastModified`. Any other value fails
+            with `invalid_sort_order`.
+    EDILifecycleSearchGroup:
+      type: object
+      required:
+        - groupKey
+        - hasChildren
+        - latestTransaction
+        - ediTransactions
+      description: |-
+        One lifecycle group that contains a keyword match, with its newest member
+        as the parent row and every other member loaded beneath it.
+      properties:
+        groupKey:
+          $ref: '#/components/schemas/EDILifecycleGroupKey'
+        hasChildren:
+          type: boolean
+          description: When true, the group has two or more members.
+        latestDateTime:
+          type:
+            - string
+            - 'null'
+          format: date-time
+          description: Timestamp of the group's newest member.
+        lifecycleStatus:
+          type: string
+          description: Lifecycle step of the group's newest member, one of the `lifecycleStatus` values on the EDI transaction.
+        latestTransaction:
+          $ref: '#/components/schemas/EDITransaction'
+        ediTransactions:
           type: array
-          items:
-            $ref: '#/components/schemas/EDIDashboardDirection'
           description: |-
-            Directions to match. Lowercase here, unlike the capitalized
-            `direction` values on the returned records.
-        faStatus:
+            The group's other members, newest first; empty for a one-document
+            group. Each carries `matchedFields` when the keyword matched it.
+          items:
+            $ref: '#/components/schemas/EDITransaction'
+        relationshipMetadata:
+          $ref: '#/components/schemas/EDIRelationshipMetadata'
+    EDITransactionsSearchPageToken:
+      type: object
+      description: Holds `next` while more results remain; empty on the last page.
+      properties:
+        next:
+          type: string
+          description: Pass back as `pageToken` with the same request body to get the next page.
+    EDITransactionsSearchListWindow:
+      type: object
+      required:
+        - ediTransactions
+        - matchedHiddenColumns
+        - pageToken
+      description: The list window of a dual search page.
+      properties:
+        ediTransactions:
           type: array
+          description: Matching transaction rows.
           items:
-            $ref: '#/components/schemas/EDIDashboardFAStatus'
-          description: Functional acknowledgment statuses to match.
-        partner:
+            $ref: '#/components/schemas/EDITransaction'
+        matchedHiddenColumns:
           type: array
           items:
             type: string
-          description: |-
-            Trading partner names to match against each record's
-            `tradingPartnerName`. Use the values `GET /v1/ediTransactions/filter-options`
-            returns in `partner`.
-          examples:
-            - - Globex Retail
-        lifecycleStatus:
+          description: Fields that matched the keyword but are not in `visibleColumns.list`.
+        totalCount:
+          type:
+            - integer
+            - 'null'
+          description: |-
+            Number of matching transactions when `filters` narrows the search;
+            null on an unfiltered keyword search, where the count is not
+            computed. Omitted on continuation pages.
+        isApproximate:
+          type: boolean
+          description: Present and true when the count hit its cap or was not computed (every unfiltered keyword search).
+        pageToken:
+          $ref: '#/components/schemas/EDITransactionsSearchPageToken'
+    EDITransactionsSearchLifecycleWindow:
+      type: object
+      required:
+        - ediTransactions
+        - matchedHiddenColumns
+        - pageToken
+      description: The lifecycle window of a dual search page.
+      properties:
+        ediTransactions:
+          type: array
+          description: Lifecycle groups that contain a match, each with its members loaded.
+          items:
+            $ref: '#/components/schemas/EDILifecycleSearchGroup'
+        matchedHiddenColumns:
           type: array
           items:
             type: string
+          description: Fields that matched the keyword but are not in `visibleColumns.lifecycle`.
+        totalCount:
+          type:
+            - integer
+            - 'null'
+          description: |-
+            Number of matching transactions when `filters` narrows the search;
+            null on an unfiltered keyword search, where the count is not
+            computed. Omitted on continuation pages.
+        totalGroups:
+          type:
+            - integer
+            - 'null'
+          description: Number of matching lifecycle groups. First page only.
+        isApproximate:
+          type: boolean
+          description: Present and true when a count hit its cap or was not computed (every unfiltered keyword search).
+        pageToken:
+          $ref: '#/components/schemas/EDITransactionsSearchPageToken'
+    EDITransactionsSearchSort:
+      type: object
+      required:
+        - sortBy
+        - order
+      description: |-
+        Effective list sort. Returned only when the request, or its `pageToken`,
+        named a sort. On a dual response it sits at the top level, not inside
+        the list window.
+      properties:
+        sortBy:
+          type: string
+          enum:
+            - relevance
+            - lastModified
+            - tradingPartnerName
+          x-enumDescriptions:
+            relevance: Best match first.
+            lastModified: Sorted by last activity.
+            tradingPartnerName: Sorted by trading partner name.
+          description: Sort applied to the list window.
+        order:
+          type: string
+          enum:
+            - asc
+            - desc
+          x-enumDescriptions:
+            asc: Ascending.
+            desc: Descending.
+          description: Sort direction applied.
+    EDITransactionsSearchResponse:
+      type: object
+      description: |-
+        One page of keyword-search results. With `viewMode: dual` (the default),
+        `ediTransactions` is an object holding a `list` window and a `lifecycle`
+        window; with `list` or `lifecycle` it is an array and the window fields
+        sit at the top level.
+      properties:
+        ediTransactions:
+          type:
+            - array
+            - object
           description: |-
-            Order-lifecycle steps to match against each record's
-            `lifecycleStatus`. Takes the values
-            `GET /v1/ediTransactions/filter-options` returns in `lifecycleStatus`;
-            anything else is rejected.
-          examples:
-            - - PO received
-              - Invoice sent
-        mdnStatus:
+            Matching rows (`viewMode: list`), matching lifecycle groups
+            (`viewMode: lifecycle`), or both windows (`viewMode: dual`).
+          required:
+            - list
+            - lifecycle
+          properties:
+            list:
+              $ref: '#/components/schemas/EDITransactionsSearchListWindow'
+            lifecycle:
+              $ref: '#/components/schemas/EDITransactionsSearchLifecycleWindow'
+        viewMode:
+          type: string
+          enum:
+            - list
+            - lifecycle
+          x-enumDescriptions:
+            list: The page carries flat rows.
+            lifecycle: The page carries lifecycle groups.
+          description: Present on single-view responses; omitted on dual responses.
+        matchedHiddenColumns:
           type: array
           items:
-            $ref: '#/components/schemas/EDIDashboardMDNStatus'
-          description: AS2 MDN statuses to match.
-        dateRange:
-          type: object
+            type: string
+          description: |-
+            Single-view responses. Fields that matched the keyword but are not in
+            the request's `visibleColumns`, sorted by name. Empty when
+            `visibleColumns` was not sent.
+        totalCount:
+          type:
+            - integer
+            - 'null'
+          description: |-
+            Single-view responses. Number of matching transactions when `filters`
+            narrows the search; null on an unfiltered keyword search, where the
+            count is not computed and `isApproximate` is true. Omitted on
+            continuation pages.
+        totalGroups:
+          type:
+            - integer
+            - 'null'
+          description: Lifecycle responses, first page only. Number of matching lifecycle groups.
+        isApproximate:
+          type: boolean
+          description: Present and true when a count hit its cap or was not computed (every unfiltered keyword search).
+        pageToken:
+          $ref: '#/components/schemas/EDITransactionsSearchPageToken'
+        sort:
+          $ref: '#/components/schemas/EDITransactionsSearchSort'
+      if:
+        properties:
+          viewMode:
+            const: list
+        required:
+          - viewMode
+      then:
+        properties:
+          ediTransactions:
+            type: array
+            items:
+              $ref: '#/components/schemas/EDITransaction'
+        required:
+          - ediTransactions
+          - matchedHiddenColumns
+          - pageToken
+      else:
+        if:
+          properties:
+            viewMode:
+              const: lifecycle
           required:
-            - from
-            - to
-          description: Window on each record's `lastModified`.
+            - viewMode
+        then:
           properties:
-            from:
-              type: string
-              format: date
-              description: First day of the window.
-              examples:
-                - '2026-10-01'
-            to:
-              type: string
-              format: date
-              description: Last day of the window. Can equal `from`; a `to` before `from` is rejected.
-              examples:
-                - '2026-10-22'
-            fromTime:
-              type: string
-              pattern: ^([01]\d|2[0-3]):[0-5]\d:[0-5]\d$
-              description: Start time on the `from` day, so the window can begin mid-day.
-              examples:
-                - '08:30:00'
-            toTime:
-              type: string
-              pattern: ^([01]\d|2[0-3]):[0-5]\d:[0-5]\d$
-              description: End time on the `to` day, so the window can end mid-day.
-              examples:
-                - '17:45:00'
+            ediTransactions:
+              type: array
+              items:
+                $ref: '#/components/schemas/EDILifecycleSearchGroup'
+          required:
+            - ediTransactions
+            - matchedHiddenColumns
+            - pageToken
+        else:
+          properties:
+            ediTransactions:
+              type: object
+          required:
+            - ediTransactions
     EDITransactionsDownloadRequest:
       type: object
       required: