openapi: 3.0.0
info:
  title: Crashes
  description: Crash analytics APIs for fatal, nonfatal and ANR exceptions. Includes chart data for time-series trend analysis and count data with current and previous period comparisons across metrics such as users, devices, exceptions, issues, and exception-free rates.<br><br><b>Note:</b> The Crashes APIs use a different root endpoint from the other Apptics APIs. The portal ID and project ID are passed as path parameters rather than headers.<br><br>Root endpoint:<br><code>https://apptics.zoho.com/cx/</code><br>
  contact: {}
  version: 1.0.0
servers:
  - url: https://apptics.zoho.com/cx/
    description: API Endpoint
tags:
  - name: crashes
    description: Crashes Module
paths:
  /{zsoid}/{projectid}/exception/chart:
    servers:
      - url: https://apptics.zoho.com/cx
        description: Chart Data API Endpoint
    get:
      tags:
        - crashes
      summary: Get crash chart data
      description: Use this API to get chart data for fatal, nonfatal and ANR crashes. Returns time-series data for metrics such as crashes, devices, users, and issues, organized by exception type and platform (e.g., Android, iOS). For multi-day date ranges, the timeseries keys are epoch timestamps in milliseconds. For a single-day date range (via dateRangeIndex or matching startDate/endDate), the timeseries is grouped by hour and the keys are hour numbers (0–23).
      parameters:
        - name: zsoid
          in: path
          required: true
          description: Portal ID
          schema:
            type: string
          example: '10234695'
        - name: projectid
          in: path
          required: true
          description: Project ID
          schema:
            type: string
          example: '12345689'
        - name: mode
          in: query
          required: true
          description: Environment mode filter. 0 for development, 1 for production.
          schema:
            type: integer
          example: 1
        - name: dateRangeIndex
          in: query
          required: true
          description: 'Predefined date range selector. Allowed values: 0 - Today, 1 - Yesterday, 2 - Last 7 Days, 3 - Last Week, 4 - Last 14 Days, 5 - Last 30 Days, 6 - Last Month, 7 - Last 60 Days, 8 - Last 90 Days, 9 - Last 180 Days, 10 - Last 365 Days, 11 - Custom date range (startDate and endDate are mandatory when using this value).'
          schema:
            type: integer
          example: 0
        - name: group
          in: query
          required: true
          description: 'Exception group type to retrieve chart data for. Allowed values: fatal, nonfatal, error.'
          schema:
            type: string
            enum:
              - fatal
              - nonfatal
              - error
          example: fatal
        - name: startDate
          in: query
          required: false
          description: 'Beginning of date range for chart data retrieval. Required format: YYYY-MM-dd.'
          schema:
            type: string
          example: '2024-07-14'
        - name: endDate
          in: query
          required: false
          description: 'End of date range for chart data retrieval. Required format: YYYY-MM-dd.'
          schema:
            type: string
          example: '2024-07-21'
        - name: filters
          in: query
          required: false
          description: 'URL-encoded JSON object to filter chart data. Encode the JSON value before passing. Supported keys:<br><br><b>platform</b> — Single value or comma-separated list. Allowed values: Android, iOS, Linux, macOS, tvOS, visionOS, watchOS, Windows.<br><br><b>exceptiongroup</b> — Single value or comma-separated list. Allowed values: anr, applaunch, cpuexception, crash, diskwrite, hang.<br><br><b>application</b> — Single application ID or comma-separated list.<br><br><b>deviceType</b> — Single value or comma-separated list. Allowed values: Android TV(Android), Apple TV(tvOS), Apple Vision(visionOS), Apple Watch(watchOS), Chromebook(Android), Desktop(Linux), Foldables(Android), iPad(iOS), iPad Touch(iOS), iPhone(iOS), iPod Touch(iOS), mac(macOS), Mac Catalyst(macOS), Phone(Android), Tablet(Android), Windows.Desktop(Windows).<br><br><b>appversion</b> — Single value or comma-separated list. Format: appversion(platform).<br><br><b>osversion</b> — Single value or comma-separated list. Format: osversion(platform).<br><br>Example: <code>{"platform":"Android,iOS","exceptiongroup":"crash","appversion":"3.0.22(Android)"}</code>'
          schema:
            type: string
          example: '%7B%22platform%22%3A%22Android%2CiOS%22%2C%22exceptiongroup%22%3A%22crash%22%7D'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/crash_chart_data_response'
              examples:
                success:
                  summary: Successful response (multi-day range)
                  value:
                    result: success
                    data:
                      anr:
                        Android:
                          crasheschart:
                            '1775327400000': 44
                            '1774981800000': 75
                            '1774895400000': 43
                            '1775154600000': 52
                            '1775413800000': 55
                            '1775068200000': 47
                            '1775241000000': 35
                          deviceschart:
                            '1775327400000': 35
                            '1774981800000': 48
                            '1774895400000': 35
                            '1775154600000': 45
                            '1775413800000': 37
                            '1775068200000': 33
                            '1775241000000': 33
                          userschart:
                            '1775327400000': 1
                            '1774981800000': 1
                            '1774895400000': 1
                            '1775154600000': 1
                            '1775413800000': 1
                            '1775068200000': 1
                            '1775241000000': 1
                          issueschart:
                            '1775327400000': 23
                            '1774981800000': 51
                            '1774895400000': 25
                            '1775154600000': 34
                            '1775413800000': 29
                            '1775068200000': 29
                            '1775241000000': 23
                      fatal:
                        iOS:
                          crasheschart:
                            '1775327400000': 4
                            '1774981800000': 11
                            '1774895400000': 18
                            '1775154600000': 11
                            '1775413800000': 10
                            '1775068200000': 16
                            '1775241000000': 6
                          deviceschart:
                            '1775327400000': 3
                            '1774981800000': 10
                            '1774895400000': 10
                            '1775154600000': 9
                            '1775413800000': 10
                            '1775068200000': 12
                            '1775241000000': 5
                          userschart:
                            '1775327400000': 1
                            '1774981800000': 1
                            '1774895400000': 1
                            '1775154600000': 1
                            '1775413800000': 1
                            '1775068200000': 1
                            '1775241000000': 1
                          issueschart:
                            '1775327400000': 2
                            '1774981800000': 11
                            '1774895400000': 13
                            '1775154600000': 10
                            '1775413800000': 10
                            '1775068200000': 15
                            '1775241000000': 5
                        macOS:
                          crasheschart:
                            '1775327400000': 0
                            '1774981800000': 3
                            '1774895400000': 2
                            '1775154600000': 4
                            '1775413800000': 6
                            '1775068200000': 4
                            '1775241000000': 3
                          deviceschart:
                            '1775327400000': 0
                            '1774981800000': 2
                            '1774895400000': 2
                            '1775154600000': 4
                            '1775413800000': 5
                            '1775068200000': 2
                            '1775241000000': 2
                          userschart:
                            '1775327400000': 0
                            '1774981800000': 1
                            '1774895400000': 1
                            '1775154600000': 1
                            '1775413800000': 1
                            '1775068200000': 1
                            '1775241000000': 1
                          issueschart:
                            '1775327400000': 0
                            '1774981800000': 3
                            '1774895400000': 3
                            '1775154600000': 3
                            '1775413800000': 5
                            '1775068200000': 3
                            '1775241000000': 2
                        Android:
                          crasheschart:
                            '1775327400000': 114
                            '1774981800000': 271
                            '1774895400000': 146
                            '1775154600000': 146
                            '1775413800000': 161
                            '1775068200000': 152
                            '1775241000000': 110
                          deviceschart:
                            '1775327400000': 61
                            '1774981800000': 84
                            '1774895400000': 72
                            '1775154600000': 72
                            '1775413800000': 90
                            '1775068200000': 101
                            '1775241000000': 60
                          userschart:
                            '1775327400000': 1
                            '1774981800000': 1
                            '1774895400000': 1
                            '1775154600000': 2
                            '1775413800000': 1
                            '1775068200000': 1
                            '1775241000000': 1
                          issueschart:
                            '1775327400000': 48
                            '1774981800000': 53
                            '1774895400000': 44
                            '1775154600000': 50
                            '1775413800000': 52
                            '1775068200000': 57
                            '1775241000000': 41
                    status: 2000
                failure:
                  summary: Failure response
                  value:
                    result: failure
                    data: Exception Occured
                    status: 3000
      security:
        - Zoho_Auth:
            - JProxy.jmobileapi.ALL
  /{zsoid}/{projectid}/exception/{group}/count:
    servers:
      - url: https://apptics.zoho.com/cx
        description: Count Data API Endpoint
    get:
      tags:
        - crashes
      summary: Get crash count data
      description: Use this API to get count data for fatal, nonfatal and ANR crashes. Returns aggregated metrics (users, devices, exceptions, issues, unique devices, exception-free users and devices) for the specified period, along with comparative data from the equivalent previous period.
      parameters:
        - name: zsoid
          in: path
          required: true
          description: Portal ID
          schema:
            type: string
          example: '10234695'
        - name: projectid
          in: path
          required: true
          description: Project ID
          schema:
            type: string
          example: '12345689'
        - name: group
          in: path
          required: true
          description: 'Exception group type to retrieve count data for. Allowed values: fatal, nonfatal, error.'
          schema:
            type: string
            enum:
              - fatal
              - nonfatal
              - error
          example: fatal
        - name: mode
          in: query
          required: true
          description: Environment mode filter. 0 for development, 1 for production.
          schema:
            type: integer
          example: 1
        - name: dateRangeIndex
          in: query
          required: true
          description: 'Predefined date range selector. Allowed values: 0 - Today, 1 - Yesterday, 2 - Last 7 Days, 3 - Last Week, 4 - Last 14 Days, 5 - Last 30 Days, 6 - Last Month, 7 - Last 60 Days, 8 - Last 90 Days, 9 - Last 180 Days, 10 - Last 365 Days, 11 - Custom date range (startDate and endDate are mandatory when using this value).'
          schema:
            type: integer
          example: 2
        - name: startDate
          in: query
          required: false
          description: 'Beginning of date range for count data retrieval. Required format: YYYY-MM-dd.'
          schema:
            type: string
          example: '2024-07-14'
        - name: endDate
          in: query
          required: false
          description: 'End of date range for count data retrieval. Required format: YYYY-MM-dd.'
          schema:
            type: string
          example: '2024-07-21'
        - name: filters
          in: query
          required: false
          description: 'URL-encoded JSON object to filter count data. Encode the JSON value before passing. Supported keys:<br><br><b>platform</b> — Single value or comma-separated list. Allowed values: Android, iOS, Linux, macOS, tvOS, visionOS, watchOS, Windows.<br><br><b>exceptiongroup</b> — Single value or comma-separated list. Allowed values: anr, applaunch, cpuexception, crash, diskwrite, hang.<br><br><b>application</b> — Single application ID or comma-separated list.<br><br><b>deviceType</b> — Single value or comma-separated list. Allowed values: Android TV(Android), Apple TV(tvOS), Apple Vision(visionOS), Apple Watch(watchOS), Chromebook(Android), Desktop(Linux), Foldables(Android), iPad(iOS), iPad Touch(iOS), iPhone(iOS), iPod Touch(iOS), mac(macOS), Mac Catalyst(macOS), Phone(Android), Tablet(Android), Windows.Desktop(Windows).<br><br><b>appversion</b> — Single value or comma-separated list. Format: appversion(platform).<br><br><b>osversion</b> — Single value or comma-separated list. Format: osversion(platform).<br><br>Example: <code>{"platform":"Android,iOS","exceptiongroup":"crash","appversion":"3.0.22(Android)"}</code>'
          schema:
            type: string
          example: '%7B%22platform%22%3A%22Android%2CiOS%22%2C%22exceptiongroup%22%3A%22crash%22%7D'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/crash_count_data_response'
              examples:
                success:
                  summary: Successful response
                  value:
                    result: success
                    data:
                      uniqueDevices:
                        count: 204
                        preCount: 150
                      anr:
                        preCountData:
                          userCount: 1
                          exceptionCount: 1
                          deviceCount: 1
                          appVersionCount: 0
                          issueCount: 1
                        countData:
                          userCount: 7
                          exceptionCount: 12
                          deviceCount: 9
                          appVersionCount: 0
                          issueCount: 4
                        exceptionFreeDevices: 98
                        exceptionFreeUsers: 98
                      fatal:
                        preCountData:
                          userCount: 129
                          exceptionCount: 189
                          deviceCount: 149
                          appVersionCount: 0
                          issueCount: 33
                        countData:
                          userCount: 192
                          exceptionCount: 218
                          deviceCount: 201
                          appVersionCount: 0
                          issueCount: 22
                        exceptionFreeDevices: 69
                        exceptionFreeUsers: 69
                    status: 2000
                failure:
                  summary: Failure response
                  value:
                    result: failure
                    data: Exception Occured
                    status: 3000
      security:
        - Zoho_Auth:
            - JProxy.jmobileapi.ALL
  /{zsoid}/{projectid}/exception/v2/reports:
    servers:
      - url: https://apptics.zoho.com/cx
        description: Reports API Endpoint
    get:
      tags:
        - crashes
      summary: Get crash reports
      description: Use this API to get the list of crashes, non-fatals, or ANR reports for a given period. Returns a paginated list of unique crash issues with exception details, affected device and OS information, app version breakdowns, and exception counts. Use index and limit parameters for pagination.
      parameters:
        - name: zsoid
          in: path
          required: true
          description: Portal ID
          schema:
            type: string
          example: '10234695'
        - name: projectid
          in: path
          required: true
          description: Project ID
          schema:
            type: string
          example: '12345689'
        - name: mode
          in: query
          required: true
          description: Environment mode filter. 0 for development, 1 for production.
          schema:
            type: integer
          example: 1
        - name: dateRangeIndex
          in: query
          required: true
          description: 'Predefined date range selector. Allowed values: 0 - Today, 1 - Yesterday, 2 - Last 7 Days, 3 - Last Week, 4 - Last 14 Days, 5 - Last 30 Days, 6 - Last Month, 7 - Last 60 Days, 8 - Last 90 Days, 9 - Last 180 Days, 10 - Last 365 Days, 11 - Custom date range (startDate and endDate are mandatory when using this value).'
          schema:
            type: integer
          example: 2
        - name: group
          in: query
          required: true
          description: 'Exception group type to retrieve reports for. Allowed values: fatal, nonfatal, error.'
          schema:
            type: string
            enum:
              - fatal
              - nonfatal
              - error
          example: fatal
        - name: startDate
          in: query
          required: false
          description: 'Beginning of date range for report retrieval. Required format: YYYY-MM-dd.'
          schema:
            type: string
          example: '2024-01-12'
        - name: endDate
          in: query
          required: false
          description: 'End of date range for report retrieval. Required format: YYYY-MM-dd.'
          schema:
            type: string
          example: '2024-01-13'
        - name: index
          in: query
          required: false
          description: Pagination offset. Starts at 0. Pass the next index value from the previous response to retrieve the next page.
          schema:
            type: integer
          example: 0
        - name: limit
          in: query
          required: false
          description: Number of reports to return per page. Maximum allowed value is 100.
          schema:
            type: integer
          example: 100
        - name: filters
          in: query
          required: false
          description: 'URL-encoded JSON object to filter reports. Encode the JSON value before passing. Supported keys:<br><br><b>platform</b> — Single value or comma-separated list. Allowed values: Android, iOS, Linux, macOS, tvOS, visionOS, watchOS, Windows.<br><br><b>exceptiongroup</b> — Single value or comma-separated list. Allowed values: anr, applaunch, cpuexception, crash, diskwrite, hang.<br><br><b>application</b> — Single application ID or comma-separated list.<br><br><b>deviceType</b> — Single value or comma-separated list. Allowed values: Android TV(Android), Apple TV(tvOS), Apple Vision(visionOS), Apple Watch(watchOS), Chromebook(Android), Desktop(Linux), Foldables(Android), iPad(iOS), iPad Touch(iOS), iPhone(iOS), iPod Touch(iOS), mac(macOS), Mac Catalyst(macOS), Phone(Android), Tablet(Android), Windows.Desktop(Windows).<br><br><b>appversion</b> — Single value or comma-separated list. Format: appversion(platform).<br><br><b>osversion</b> — Single value or comma-separated list. Format: osversion(platform).<br><br>Example: <code>{"platform":"Android,iOS","exceptiongroup":"crash","appversion":"3.0.22(Android)"}</code>'
          schema:
            type: string
          example: '%7B%22platform%22%3A%22Android%2CiOS%22%2C%22exceptiongroup%22%3A%22crash%22%7D'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/crash_reports_response'
              examples:
                success:
                  summary: Successful response
                  value:
                    result: success
                    data:
                      reports:
                        crash+amF2YS5sYW5nLklsbGVnYWxBcmd1bWVudEV4Y2VwdGlvbiAJYXQgY29tLnpvaG8uYXBwdGljcy5HbG9iYWxLdC5zaGFyZUltYWdlKEdsb2JhbC5rdDoyMzYp:
                          exceptionType: native
                          exception: "java.lang.IllegalArgumentException \tat com.zoho.apptics.GlobalKt.shareImage(Global.kt:236)"
                          exception_Base64: amF2YS5sYW5nLklsbGVnYWxBcmd1bWVudEV4Y2VwdGlvbiAJYXQgY29tLnpvaG8uYXBwdGljcy5HbG9iYWxLdC5zaGFyZUltYWdlKEdsb2JhbC5rdDoyMzYp
                          exception_UTF8: java.lang.IllegalArgumentException+%09at+com.zoho.apptics.GlobalKt.shareImage%28Global.kt%3A236%29
                          exceptionCount: 8
                          deviceCount: 1
                          oses:
                            - Android
                          pIDs:
                            - 5000015660033
                          appVersionsCount:
                            '654146706145981':
                              appVersion: '1.17'
                              os: Android
                              exceptionCount: 8
                              deviceCount: 1
                              pID: 5000015660033
                              crashGroup: crash
                          status: 0
                          group: fatal
                          exceptionGroup: crash
                      isNextIndexValuesAvailable: false
                    status: 2000
                failure:
                  summary: Failure response
                  value:
                    result: failure
                    data: Exception Occured
                    status: 3000
      security:
        - Zoho_Auth:
            - JProxy.jmobileapi.ALL
  /{zsoid}/{projectid}/exception/uniqueCount:
    servers:
      - url: https://apptics.zoho.com/cx
        description: Unique Count Data API Endpoint
    get:
      tags:
        - crashes
      summary: Get unique crash count data
      description: Use this API to get count data for a specific unique crash issue. Returns aggregated metrics including user count, exception count, device count, app version count, and issue count for the given date range. The issueName value should be sourced from the exception_Base64 field returned by the Reports API.
      parameters:
        - name: zsoid
          in: path
          required: true
          description: Portal ID
          schema:
            type: string
          example: '10234695'
        - name: projectid
          in: path
          required: true
          description: Project ID
          schema:
            type: string
          example: '12345689'
        - name: issueName
          in: query
          required: true
          description: Unique identifier for the crash issue. Use the value from the exception_Base64 field returned by the Reports API.
          schema:
            type: string
          example: amF2YS5sYW5nLklsbGVnYWxBcmd1bWVudEV4Y2VwdGlvbiAJYXQgY29tLnpvaG8uYXBwdGljcy5HbG9iYWxLdC5zaGFyZUltYWdlKEdsb2JhbC5rdDoyMzYp
        - name: mode
          in: query
          required: true
          description: Environment mode filter. 0 for development, 1 for production.
          schema:
            type: integer
          example: 1
        - name: dateRangeIndex
          in: query
          required: true
          description: 'Predefined date range selector. Allowed values: 0 - Today, 1 - Yesterday, 2 - Last 7 Days, 3 - Last Week, 4 - Last 14 Days, 5 - Last 30 Days, 6 - Last Month, 7 - Last 60 Days, 8 - Last 90 Days, 9 - Last 180 Days, 10 - Last 365 Days, 11 - Custom date range (startDate and endDate are mandatory when using this value).'
          schema:
            type: integer
          example: 2
        - name: exceptionGroup
          in: query
          required: true
          description: 'Exception group type. Allowed values: fatal, nonfatal, anr, error.'
          schema:
            type: string
            enum:
              - fatal
              - nonfatal
              - anr
              - error
          example: fatal
        - name: startDate
          in: query
          required: false
          description: 'Beginning of date range. Required format: YYYY-MM-dd.'
          schema:
            type: string
          example: '2024-01-12'
        - name: endDate
          in: query
          required: false
          description: 'End of date range. Required format: YYYY-MM-dd.'
          schema:
            type: string
          example: '2024-01-13'
        - name: crashGroup
          in: query
          required: false
          description: 'Exception category filter. Allowed values: crash, hang, diskwrite, applaunch, cpuexception.'
          schema:
            type: string
            enum:
              - crash
              - hang
              - diskwrite
              - applaunch
              - cpuexception
          example: crash
        - name: filters
          in: query
          required: false
          description: 'URL-encoded JSON object to filter data. Encode the JSON value before passing. Supported keys:<br><br><b>platform</b> — Single value or comma-separated list. Allowed values: Android, iOS, Linux, macOS, tvOS, visionOS, watchOS, Windows.<br><br><b>exceptiongroup</b> — Single value or comma-separated list. Allowed values: anr, applaunch, cpuexception, crash, diskwrite, hang.<br><br><b>application</b> — Single application ID or comma-separated list.<br><br><b>deviceType</b> — Single value or comma-separated list. Allowed values: Android TV(Android), Apple TV(tvOS), Apple Vision(visionOS), Apple Watch(watchOS), Chromebook(Android), Desktop(Linux), Foldables(Android), iPad(iOS), iPad Touch(iOS), iPhone(iOS), iPod Touch(iOS), mac(macOS), Mac Catalyst(macOS), Phone(Android), Tablet(Android), Windows.Desktop(Windows).<br><br><b>appversion</b> — Single value or comma-separated list. Format: appversion(platform).<br><br><b>osversion</b> — Single value or comma-separated list. Format: osversion(platform).<br><br>Example: <code>{"platform":"Android,iOS","exceptiongroup":"crash","appversion":"3.0.22(Android)"}</code>'
          schema:
            type: string
          example: '%7B%22platform%22%3A%22Android%2CiOS%22%2C%22exceptiongroup%22%3A%22crash%22%7D'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/unique_crash_count_response'
              examples:
                success:
                  summary: Successful response
                  value:
                    result: success
                    data:
                      userCount: 17
                      exceptionCount: 19
                      deviceCount: 19
                      appVersionCount: 3
                      issueCount: 1
                    status: 2000
                failure:
                  summary: Failure response
                  value:
                    result: failure
                    data: Exception Occured
                    status: 3000
      security:
        - Zoho_Auth:
            - JProxy.jmobileapi.ALL
  /{zsoid}/{projectid}/exception/uniqueChart:
    servers:
      - url: https://apptics.zoho.com/cx
        description: Unique Chart Data API Endpoint
    get:
      tags:
        - crashes
      summary: Get unique crash chart data
      description: Use this API to get time-series chart data for a specific unique crash issue. Returns crash, device, user, and issue counts keyed by epoch timestamp. For multi-day date ranges, keys are epoch timestamps in milliseconds. For a single-day date range, the timeseries is grouped by hour and the keys are hour numbers (0–23). The issueName value should be sourced from the exception_Base64 field returned by the Reports API.
      parameters:
        - name: zsoid
          in: path
          required: true
          description: Portal ID
          schema:
            type: string
          example: '10234695'
        - name: projectid
          in: path
          required: true
          description: Project ID
          schema:
            type: string
          example: '12345689'
        - name: issueName
          in: query
          required: true
          description: Unique identifier for the crash issue. Use the value from the exception_Base64 field returned by the Reports API.
          schema:
            type: string
          example: amF2YS5sYW5nLklsbGVnYWxBcmd1bWVudEV4Y2VwdGlvbiAJYXQgY29tLnpvaG8uYXBwdGljcy5HbG9iYWxLdC5zaGFyZUltYWdlKEdsb2JhbC5rdDoyMzYp
        - name: mode
          in: query
          required: true
          description: Environment mode filter. 0 for development, 1 for production.
          schema:
            type: integer
          example: 1
        - name: exceptionGroup
          in: query
          required: true
          description: 'Exception group type. Allowed values: fatal, nonfatal, anr, error.'
          schema:
            type: string
            enum:
              - fatal
              - nonfatal
              - anr
              - error
          example: fatal
        - name: dateRangeIndex
          in: query
          required: true
          description: 'Predefined date range selector. Allowed values: 0 - Today, 1 - Yesterday, 2 - Last 7 Days, 3 - Last Week, 4 - Last 14 Days, 5 - Last 30 Days, 6 - Last Month, 7 - Last 60 Days, 8 - Last 90 Days, 9 - Last 180 Days, 10 - Last 365 Days, 11 - Custom date range (startDate and endDate are mandatory when using this value).'
          schema:
            type: integer
          example: 2
        - name: startDate
          in: query
          required: false
          description: 'Beginning of date range. Required format: YYYY-MM-dd.'
          schema:
            type: string
          example: '2024-07-14'
        - name: endDate
          in: query
          required: false
          description: 'End of date range. Required format: YYYY-MM-dd.'
          schema:
            type: string
          example: '2024-07-21'
        - name: crashGroup
          in: query
          required: false
          description: 'Exception category filter. Allowed values: crash, hang, diskwrite, applaunch, cpuexception.'
          schema:
            type: string
            enum:
              - crash
              - hang
              - diskwrite
              - applaunch
              - cpuexception
          example: crash
        - name: filters
          in: query
          required: false
          description: 'URL-encoded JSON object to filter data. Encode the JSON value before passing. Supported keys:<br><br><b>platform</b> — Single value or comma-separated list. Allowed values: Android, iOS, Linux, macOS, tvOS, visionOS, watchOS, Windows.<br><br><b>exceptiongroup</b> — Single value or comma-separated list. Allowed values: anr, applaunch, cpuexception, crash, diskwrite, hang.<br><br><b>application</b> — Single application ID or comma-separated list.<br><br><b>deviceType</b> — Single value or comma-separated list. Allowed values: Android TV(Android), Apple TV(tvOS), Apple Vision(visionOS), Apple Watch(watchOS), Chromebook(Android), Desktop(Linux), Foldables(Android), iPad(iOS), iPad Touch(iOS), iPhone(iOS), iPod Touch(iOS), mac(macOS), Mac Catalyst(macOS), Phone(Android), Tablet(Android), Windows.Desktop(Windows).<br><br><b>appversion</b> — Single value or comma-separated list. Format: appversion(platform).<br><br><b>osversion</b> — Single value or comma-separated list. Format: osversion(platform).<br><br>Example: <code>{"platform":"Android,iOS","exceptiongroup":"crash","appversion":"3.0.22(Android)"}</code>'
          schema:
            type: string
          example: '%7B%22platform%22%3A%22Android%2CiOS%22%2C%22exceptiongroup%22%3A%22crash%22%7D'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/unique_crash_chart_response'
              examples:
                success:
                  summary: Successful response (multi-day range)
                  value:
                    result: success
                    data:
                      crasheschart:
                        '1720895400000': 2
                        '1720722600000': 17
                        '1720549800000': 0
                        '1720636200000': 0
                        '1720809000000': 0
                        '1721068200000': 0
                        '1720981800000': 0
                      deviceschart:
                        '1720895400000': 2
                        '1720722600000': 17
                        '1720549800000': 0
                        '1720636200000': 0
                        '1720809000000': 0
                        '1721068200000': 0
                        '1720981800000': 0
                      userschart:
                        '1720895400000': 2
                        '1720722600000': 15
                        '1720549800000': 0
                        '1720636200000': 0
                        '1720809000000': 0
                        '1721068200000': 0
                        '1720981800000': 0
                      issueschart:
                        '1720895400000': 1
                        '1720722600000': 1
                        '1720549800000': 0
                        '1720636200000': 0
                        '1720809000000': 0
                        '1721068200000': 0
                        '1720981800000': 0
                    status: 2000
                failure:
                  summary: Failure response
                  value:
                    result: failure
                    data: Exception Occured
                    status: 3000
      security:
        - Zoho_Auth:
            - JProxy.jmobileapi.ALL
  /{zsoid}/{projectid}/exception/uniqueTrace:
    servers:
      - url: https://apptics.zoho.com/cx
        description: Unique Trace API Endpoint
    get:
      tags:
        - crashes
      summary: Get unique crash trace
      description: Use this API to get the detailed stack trace and metadata for a specific unique crash issue. Returns full exception details including the stack trace, device context, user information, session data, and any comments added to the issue. The issueName value should be sourced from the exception_Base64 field returned by the Reports API.
      parameters:
        - name: zsoid
          in: path
          required: true
          description: Portal ID
          schema:
            type: string
          example: '10234695'
        - name: projectid
          in: path
          required: true
          description: Project ID
          schema:
            type: string
          example: '12345689'
        - name: issueName
          in: query
          required: true
          description: Unique identifier for the crash issue. Use the value from the exception_Base64 field returned by the Reports API.
          schema:
            type: string
          example: amF2YS5sYW5nLklsbGVnYWxBcmd1bWVudEV4Y2VwdGlvbiBhdCBjb20uem9oby5hcHB0aWNzRmx1dHRlckV4YW1wbGUuY29yZS5lbmdhZ2UuRXZlbnRUeXBlLnZhbHVlT2YobnVsbDoyKQ==
        - name: mode
          in: query
          required: true
          description: Environment mode filter. 0 for development, 1 for production.
          schema:
            type: integer
          example: 1
        - name: exceptionGroup
          in: query
          required: true
          description: 'Exception group type. Allowed values: fatal, nonfatal, anr, error.'
          schema:
            type: string
            enum:
              - fatal
              - nonfatal
              - anr
              - error
          example: anr
        - name: dateRangeIndex
          in: query
          required: true
          description: 'Predefined date range selector. Allowed values: 0 - Today, 1 - Yesterday, 2 - Last 7 Days, 3 - Last Week, 4 - Last 14 Days, 5 - Last 30 Days, 6 - Last Month, 7 - Last 60 Days, 8 - Last 90 Days, 9 - Last 180 Days, 10 - Last 365 Days, 11 - Custom date range (startDate and endDate are mandatory when using this value).'
          schema:
            type: integer
          example: 2
        - name: startDate
          in: query
          required: false
          description: 'Beginning of date range. Required format: YYYY-MM-dd.'
          schema:
            type: string
          example: '2024-07-14'
        - name: endDate
          in: query
          required: false
          description: 'End of date range. Required format: YYYY-MM-dd.'
          schema:
            type: string
          example: '2024-07-21'
        - name: crashGroup
          in: query
          required: false
          description: 'Exception category filter. Allowed values: crash, hang, diskwrite, applaunch, cpuexception.'
          schema:
            type: string
            enum:
              - crash
              - hang
              - diskwrite
              - applaunch
              - cpuexception
          example: crash
        - name: filters
          in: query
          required: false
          description: 'URL-encoded JSON object to filter data. Encode the JSON value before passing. Supported keys:<br><br><b>platform</b> — Single value or comma-separated list. Allowed values: Android, iOS, Linux, macOS, tvOS, visionOS, watchOS, Windows.<br><br><b>exceptiongroup</b> — Single value or comma-separated list. Allowed values: anr, applaunch, cpuexception, crash, diskwrite, hang.<br><br><b>application</b> — Single application ID or comma-separated list.<br><br><b>deviceType</b> — Single value or comma-separated list. Allowed values: Android TV(Android), Apple TV(tvOS), Apple Vision(visionOS), Apple Watch(watchOS), Chromebook(Android), Desktop(Linux), Foldables(Android), iPad(iOS), iPad Touch(iOS), iPhone(iOS), iPod Touch(iOS), mac(macOS), Mac Catalyst(macOS), Phone(Android), Tablet(Android), Windows.Desktop(Windows).<br><br><b>appversion</b> — Single value or comma-separated list. Format: appversion(platform).<br><br><b>osversion</b> — Single value or comma-separated list. Format: osversion(platform).<br><br>Example: <code>{"platform":"Android,iOS","exceptiongroup":"crash","appversion":"3.0.22(Android)"}</code>'
          schema:
            type: string
          example: '%7B%22platform%22%3A%22Android%2CiOS%22%2C%22exceptiongroup%22%3A%22crash%22%7D'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/unique_crash_trace_response'
              examples:
                success:
                  summary: Successful response
                  value:
                    result: success
                    data:
                      date: 01 Jan 2025, 09:15 AM
                      exception: java.lang.NullPointerException at com.example.sampleapp.MainActivity.onCreate(MainActivity.java:42)
                      exception_Base64: amF2YS5sYW5nLk51bGxQb2ludGVyRXhjZXB0aW9uIGF0IGNvbS5leGFtcGxlLnNhbXBsZWFwcC5NYWluQWN0aXZpdHkub25DcmVhdGUoTWFpbkFjdGl2aXR5LmphdmE6NDIp
                      exception_UTF8: java.lang.NullPointerException+at+com.example.sampleapp.MainActivity.onCreate%28MainActivity.java%3A42%29
                      appVersionID: 100000000000001
                      exceptionType: native
                      bugURL: '--'
                      appVersion: 2.1.0
                      issueName: java.lang.NullPointerException at com.example.sampleapp.MainActivity.onCreate(MainActivity.java:42)
                      networkStatus: '1'
                      screen: HomeScreen
                      platformID: 200000000000001
                      happenedAt: 1775241202734
                      userID: '300000000000001'
                      exceptionGroup: anr
                      edge: 4G
                      osVersion: '14'
                      bugID: '--'
                      projectID: 0
                      group: anr
                      identifier: com.example.sampleapp
                      orientation: Portrait
                      comments:
                        - time: 1775644198799
                          message: Investigating this issue
                          userName: Jane Smith
                          user: 400000000000001
                          email: jane.smith@example.com
                          zuID: 500000000001
                      os: Android
                      sessionStartTime: '1775237602405'
                      Severity: '0'
                      message: "java.lang.NullPointerException\n\tat com.example.sampleapp.MainActivity.onCreate(MainActivity.java:42)\n\tat android.app.Activity.performCreate(Activity.java:8051)\n\tat android.app.Instrumentation.callActivityOnCreate(Instrumentation.java:1329)\n\tat android.app.ActivityThread.performLaunchActivity(ActivityThread.java:3608)"
                      deviceID: '600000000000001'
                      insertTime: 1775241202792
                      customProperties: '{}'
                      batteryStatus: '85'
                      portalID: '0'
                      appReleaseVersion: 2.1.3
                      deviceModel: Pixel 6
                      status: 0
                    status: 2000
                failure:
                  summary: Failure response
                  value:
                    result: failure
                    data: Exception Occured
                    status: 3000
      security:
        - Zoho_Auth:
            - JProxy.jmobileapi.ALL
  /{zsoid}/{projectid}/exception/devices:
    servers:
      - url: https://apptics.zoho.com/cx
        description: Affected Devices API Endpoint
    get:
      tags:
        - crashes
      summary: Get affected devices
      description: Use this API to get the list of devices affected by a specific unique crash issue. Returns a paginated list of device records with device model, OS version, app version, and crash timestamps. The issueName value should be sourced from the exception_Base64 field returned by the Reports API.
      parameters:
        - name: zsoid
          in: path
          required: true
          description: Portal ID
          schema:
            type: string
          example: '10234695'
        - name: projectid
          in: path
          required: true
          description: Project ID
          schema:
            type: string
          example: '12345689'
        - name: issueName
          in: query
          required: true
          description: Unique identifier for the crash issue. Use the value from the exception_Base64 field returned by the Reports API.
          schema:
            type: string
          example: amF2YS5sYW5nLk51bGxQb2ludGVyRXhjZXB0aW9uIGF0IGNvbS5leGFtcGxlLnNhbXBsZWFwcC5NYWluQWN0aXZpdHkub25DcmVhdGUoTWFpbkFjdGl2aXR5LmphdmE6NDIp
        - name: mode
          in: query
          required: true
          description: Environment mode filter. 0 for development, 1 for production.
          schema:
            type: integer
          example: 1
        - name: exceptionGroup
          in: query
          required: true
          description: 'Exception group type. Allowed values: fatal, nonfatal, anr, error.'
          schema:
            type: string
            enum:
              - fatal
              - nonfatal
              - anr
              - error
          example: fatal
        - name: dateRangeIndex
          in: query
          required: true
          description: 'Predefined date range selector. Allowed values: 0 - Today, 1 - Yesterday, 2 - Last 7 Days, 3 - Last Week, 4 - Last 14 Days, 5 - Last 30 Days, 6 - Last Month, 7 - Last 60 Days, 8 - Last 90 Days, 9 - Last 180 Days, 10 - Last 365 Days, 11 - Custom date range (startDate and endDate are mandatory when using this value).'
          schema:
            type: integer
          example: 2
        - name: startDate
          in: query
          required: false
          description: 'Beginning of date range. Required format: YYYY-MM-dd.'
          schema:
            type: string
          example: '2024-07-14'
        - name: endDate
          in: query
          required: false
          description: 'End of date range. Required format: YYYY-MM-dd.'
          schema:
            type: string
          example: '2024-07-21'
        - name: crashGroup
          in: query
          required: false
          description: 'Exception category filter. Allowed values: crash, hang, diskwrite, applaunch, cpuexception.'
          schema:
            type: string
            enum:
              - crash
              - hang
              - diskwrite
              - applaunch
              - cpuexception
          example: crash
        - name: index
          in: query
          required: false
          description: Pagination offset. Starts at 0.
          schema:
            type: integer
          example: 0
        - name: limit
          in: query
          required: false
          description: 'Number of records to return per page. Default and maximum: 500.'
          schema:
            type: integer
          example: 500
        - name: filters
          in: query
          required: false
          description: 'URL-encoded JSON object to filter data. Encode the JSON value before passing. Supported keys:<br><br><b>platform</b> — Single value or comma-separated list. Allowed values: Android, iOS, Linux, macOS, tvOS, visionOS, watchOS, Windows.<br><br><b>exceptiongroup</b> — Single value or comma-separated list. Allowed values: anr, applaunch, cpuexception, crash, diskwrite, hang.<br><br><b>application</b> — Single application ID or comma-separated list.<br><br><b>deviceType</b> — Single value or comma-separated list. Allowed values: Android TV(Android), Apple TV(tvOS), Apple Vision(visionOS), Apple Watch(watchOS), Chromebook(Android), Desktop(Linux), Foldables(Android), iPad(iOS), iPad Touch(iOS), iPhone(iOS), iPod Touch(iOS), mac(macOS), Mac Catalyst(macOS), Phone(Android), Tablet(Android), Windows.Desktop(Windows).<br><br><b>appversion</b> — Single value or comma-separated list. Format: appversion(platform).<br><br><b>osversion</b> — Single value or comma-separated list. Format: osversion(platform).<br><br>Example: <code>{"platform":"Android,iOS","exceptiongroup":"crash","appversion":"3.0.22(Android)"}</code>'
          schema:
            type: string
          example: '%7B%22platform%22%3A%22Android%2CiOS%22%2C%22exceptiongroup%22%3A%22crash%22%7D'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/affected_devices_list_response'
              examples:
                success:
                  summary: Successful response
                  value:
                    result: success
                    data:
                      - date: 1720896898977
                        recievedAtAsDate: 14 Jul 2024, 12:24 AM
                        appVersion: 2.1.0
                        osVersion: '14'
                        model: Pixel 6
                        deviceID: '100000000000001'
                        happendAtAsDate: 14 Jul 2024, 12:24 AM
                        happendAt: 1720896898887
                      - date: 1720723760707
                        recievedAtAsDate: 12 Jul 2024, 12:19 AM
                        appVersion: 2.1.0
                        osVersion: '17'
                        model: iPhone 14
                        deviceID: '200000000000002'
                        happendAtAsDate: 12 Jul 2024, 12:19 AM
                        happendAt: 1720723760633
                      - date: 1720723758331
                        recievedAtAsDate: 12 Jul 2024, 12:19 AM
                        appVersion: 2.0.0
                        osVersion: '13'
                        model: Samsung Galaxy S21
                        deviceID: '300000000000003'
                        happendAtAsDate: 12 Jul 2024, 12:19 AM
                        happendAt: 1720723758253
                    status: 2000
                failure:
                  summary: Failure response
                  value:
                    result: failure
                    data: Exception Occured
                    status: 3000
      security:
        - Zoho_Auth:
            - JProxy.jmobileapi.ALL
  /{zsoid}/{projectid}/exception/uniqueDeviceDetailsChart:
    servers:
      - url: https://apptics.zoho.com/cx
        description: Unique Device Details Chart API Endpoint
    get:
      tags:
        - crashes
      summary: Get crash distribution by device, OS and app version
      description: Use this API to get the distribution of a specific unique crash issue across device models, OS versions, and app versions. Returns crash counts grouped by each dimension for the given date range. The issueName value should be sourced from the exception_Base64 field returned by the Reports API.
      parameters:
        - name: zsoid
          in: path
          required: true
          description: Portal ID
          schema:
            type: string
          example: '10234695'
        - name: projectid
          in: path
          required: true
          description: Project ID
          schema:
            type: string
          example: '12345689'
        - name: issueName
          in: query
          required: true
          description: Unique identifier for the crash issue. Use the value from the exception_Base64 field returned by the Reports API.
          schema:
            type: string
          example: amF2YS5sYW5nLk51bGxQb2ludGVyRXhjZXB0aW9uIGF0IGNvbS5leGFtcGxlLnNhbXBsZWFwcC5NYWluQWN0aXZpdHkub25DcmVhdGUoTWFpbkFjdGl2aXR5LmphdmE6NDIp
        - name: mode
          in: query
          required: true
          description: Environment mode filter. 0 for development, 1 for production.
          schema:
            type: integer
          example: 1
        - name: exceptionGroup
          in: query
          required: true
          description: 'Exception group type. Allowed values: fatal, nonfatal, anr, error.'
          schema:
            type: string
            enum:
              - fatal
              - nonfatal
              - anr
              - error
          example: fatal
        - name: dateRangeIndex
          in: query
          required: true
          description: 'Predefined date range selector. Allowed values: 0 - Today, 1 - Yesterday, 2 - Last 7 Days, 3 - Last Week, 4 - Last 14 Days, 5 - Last 30 Days, 6 - Last Month, 7 - Last 60 Days, 8 - Last 90 Days, 9 - Last 180 Days, 10 - Last 365 Days, 11 - Custom date range (startDate and endDate are mandatory when using this value).'
          schema:
            type: integer
          example: 2
        - name: startDate
          in: query
          required: false
          description: 'Beginning of date range. Required format: YYYY-MM-dd.'
          schema:
            type: string
          example: '2024-07-14'
        - name: endDate
          in: query
          required: false
          description: 'End of date range. Required format: YYYY-MM-dd.'
          schema:
            type: string
          example: '2024-07-21'
        - name: crashGroup
          in: query
          required: false
          description: 'Exception category filter. Allowed values: crash, hang, diskwrite, applaunch, cpuexception.'
          schema:
            type: string
            enum:
              - crash
              - hang
              - diskwrite
              - applaunch
              - cpuexception
          example: crash
        - name: filters
          in: query
          required: false
          description: 'URL-encoded JSON object to filter data. Encode the JSON value before passing. Supported keys:<br><br><b>platform</b> — Single value or comma-separated list. Allowed values: Android, iOS, Linux, macOS, tvOS, visionOS, watchOS, Windows.<br><br><b>exceptiongroup</b> — Single value or comma-separated list. Allowed values: anr, applaunch, cpuexception, crash, diskwrite, hang.<br><br><b>application</b> — Single application ID or comma-separated list.<br><br><b>deviceType</b> — Single value or comma-separated list. Allowed values: Android TV(Android), Apple TV(tvOS), Apple Vision(visionOS), Apple Watch(watchOS), Chromebook(Android), Desktop(Linux), Foldables(Android), iPad(iOS), iPad Touch(iOS), iPhone(iOS), iPod Touch(iOS), mac(macOS), Mac Catalyst(macOS), Phone(Android), Tablet(Android), Windows.Desktop(Windows).<br><br><b>appversion</b> — Single value or comma-separated list. Format: appversion(platform).<br><br><b>osversion</b> — Single value or comma-separated list. Format: osversion(platform).<br><br>Example: <code>{"platform":"Android,iOS","exceptiongroup":"crash","appversion":"3.0.22(Android)"}</code>'
          schema:
            type: string
          example: '%7B%22platform%22%3A%22Android%2CiOS%22%2C%22exceptiongroup%22%3A%22crash%22%7D'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/unique_device_details_chart_response'
              examples:
                success:
                  summary: Successful response
                  value:
                    result: success
                    data:
                      deviceChart:
                        - deviceModel: Pixel 6
                          count: '8'
                        - deviceModel: Samsung Galaxy S21
                          count: '5'
                        - deviceModel: iPhone 14
                          count: '3'
                      appVersionChart:
                        - appVersion: 2.0.0
                          count: '9'
                        - appVersion: 2.1.0
                          count: '5'
                        - appVersion: 2.1.3
                          count: '2'
                      osVersionChart:
                        - osVersion: '13'
                          count: '5'
                        - osVersion: '14'
                          count: '8'
                        - osVersion: '17'
                          count: '3'
                    status: 2000
                failure:
                  summary: Failure response
                  value:
                    result: failure
                    data: Exception Occured
                    status: 3000
      security:
        - Zoho_Auth:
            - JProxy.jmobileapi.ALL
components:
  schemas:
    unique_device_details_chart_response:
      type: object
      properties:
        result:
          type: string
          example: success
        data:
          type: object
          properties:
            deviceChart:
              type: array
              description: Crash count distribution by device model
              items:
                type: object
                properties:
                  deviceModel:
                    type: string
                    example: Pixel 6
                  count:
                    type: string
                    example: '8'
            appVersionChart:
              type: array
              description: Crash count distribution by app version
              items:
                type: object
                properties:
                  appVersion:
                    type: string
                    example: 2.1.0
                  count:
                    type: string
                    example: '5'
            osVersionChart:
              type: array
              description: Crash count distribution by OS version
              items:
                type: object
                properties:
                  osVersion:
                    type: string
                    example: '14'
                  count:
                    type: string
                    example: '8'
        status:
          type: integer
          example: 2000
    affected_devices_list_response:
      type: object
      properties:
        result:
          type: string
          example: success
        data:
          type: array
          description: List of devices affected by the specified crash issue
          items:
            type: object
            properties:
              date:
                type: integer
                description: Epoch timestamp (ms) when the crash report was received
                example: 1720896898977
              recievedAtAsDate:
                type: string
                description: Formatted date and time when the crash report was received
                example: 14 Jul 2024, 12:24 AM
              appVersion:
                type: string
                description: App version installed on the affected device
                example: 2.1.0
              osVersion:
                type: string
                description: OS version of the affected device
                example: '14'
              model:
                type: string
                description: Device model name
                example: Pixel 6
              deviceID:
                type: string
                description: Unique device identifier
                example: '100000000000001'
              happendAtAsDate:
                type: string
                description: Formatted date and time when the crash occurred
                example: 14 Jul 2024, 12:24 AM
              happendAt:
                type: integer
                description: Epoch timestamp (ms) when the crash occurred
                example: 1720896898887
        status:
          type: integer
          example: 2000
    unique_crash_trace_response:
      type: object
      properties:
        result:
          type: string
          example: success
        data:
          type: object
          properties:
            date:
              type: string
              description: Formatted date and time when the crash occurred
              example: 04 Apr 2026, 12:03 AM
            exception:
              type: string
              description: Exception message and location
              example: java.lang.NullPointerException at com.example.sampleapp.MainActivity.onCreate(MainActivity.java:42)
            exception_Base64:
              type: string
              description: Base64-encoded exception string
              example: amF2YS5sYW5nLk51bGxQb2ludGVyRXhjZXB0aW9uIGF0IGNvbS5leGFtcGxlLnNhbXBsZWFwcC5NYWluQWN0aXZpdHkub25DcmVhdGUoTWFpbkFjdGl2aXR5LmphdmE6NDIp
            exception_UTF8:
              type: string
              description: URL-encoded UTF-8 representation of the exception string
              example: java.lang.NullPointerException+at+com.example.sampleapp.MainActivity.onCreate%28MainActivity.java%3A42%29
            message:
              type: string
              description: Full stack trace of the crash
              example: "java.lang.NullPointerException\n\tat com.example.sampleapp.MainActivity.onCreate(MainActivity.java:42)\n\tat android.app.Activity.performCreate(Activity.java:8051)"
            issueName:
              type: string
              description: Human-readable issue name
              example: java.lang.NullPointerException at com.example.sampleapp.MainActivity.onCreate(MainActivity.java:42)
            exceptionType:
              type: string
              description: Type of exception (e.g., native, java)
              example: native
            exceptionGroup:
              type: string
              description: Exception group (e.g., anr, fatal, nonfatal)
              example: anr
            group:
              type: string
              description: Crash group
              example: anr
            appVersion:
              type: string
              description: App version in which the crash occurred
              example: 2.1.0
            appVersionID:
              type: integer
              description: Internal app version identifier
              example: 100000000000001
            appReleaseVersion:
              type: string
              description: App release version string
              example: 2.1.3
            identifier:
              type: string
              description: App bundle identifier
              example: com.example.sampleapp
            os:
              type: string
              description: Operating system name
              example: Android
            osVersion:
              type: string
              description: Operating system version
              example: '14'
            deviceModel:
              type: string
              description: Device model name
              example: Pixel 6
            deviceID:
              type: string
              description: Unique device identifier
              example: '600000000000001'
            orientation:
              type: string
              description: Device orientation at the time of crash
              example: Portrait
            screen:
              type: string
              description: Screen or activity where the crash occurred
              example: HomeScreen
            networkStatus:
              type: string
              description: Network connectivity status at the time of crash
              example: '1'
            edge:
              type: string
              description: Network edge type (e.g., 4G, WiFi)
              example: 4G
            batteryStatus:
              type: string
              description: Battery percentage at the time of crash
              example: '85'
            userID:
              type: string
              description: User identifier
              example: '300000000000001'
            sessionStartTime:
              type: string
              description: Epoch timestamp (ms) when the session started
              example: '1775237602405'
            happenedAt:
              type: integer
              description: Epoch timestamp (ms) when the crash occurred
              example: 1775241202734
            insertTime:
              type: integer
              description: Epoch timestamp (ms) when the crash was recorded
              example: 1775241202792
            customProperties:
              type: string
              description: Custom properties associated with the crash
              example: '{}'
            platformID:
              type: integer
              example: 200000000000001
            projectID:
              type: integer
              example: 0
            portalID:
              type: string
              example: '0'
            Severity:
              type: string
              description: Crash severity level
              example: '0'
            bugID:
              type: string
              description: Associated bug tracker ID
              example: '--'
            bugURL:
              type: string
              description: Associated bug tracker URL
              example: '--'
            status:
              type: integer
              example: 0
            comments:
              type: array
              description: List of comments added to this crash issue
              items:
                type: object
                properties:
                  time:
                    type: integer
                    description: Epoch timestamp (ms) when the comment was added
                    example: 1775644198799
                  message:
                    type: string
                    example: Investigating this issue
                  userName:
                    type: string
                    example: Jane Smith
                  user:
                    type: integer
                    example: 400000000000001
                  email:
                    type: string
                    example: jane.smith@example.com
                  zuID:
                    type: integer
                    example: 500000000001
        status:
          type: integer
          example: 2000
    unique_crash_chart_response:
      type: object
      properties:
        result:
          type: string
          example: success
        data:
          type: object
          properties:
            crasheschart:
              type: object
              description: Time-series crash count. Keys are epoch timestamps in milliseconds for multi-day ranges, or hour numbers (0–23) for single-day ranges.
              additionalProperties:
                type: integer
              example:
                '1720895400000': 2
                '1720722600000': 17
            deviceschart:
              type: object
              description: Time-series device count. Keys are epoch timestamps in milliseconds for multi-day ranges, or hour numbers (0–23) for single-day ranges.
              additionalProperties:
                type: integer
              example:
                '1720895400000': 2
                '1720722600000': 17
            userschart:
              type: object
              description: Time-series user count. Keys are epoch timestamps in milliseconds for multi-day ranges, or hour numbers (0–23) for single-day ranges.
              additionalProperties:
                type: integer
              example:
                '1720895400000': 2
                '1720722600000': 15
            issueschart:
              type: object
              description: Time-series issue count. Keys are epoch timestamps in milliseconds for multi-day ranges, or hour numbers (0–23) for single-day ranges.
              additionalProperties:
                type: integer
              example:
                '1720895400000': 1
                '1720722600000': 1
        status:
          type: integer
          example: 2000
    unique_crash_count_response:
      type: object
      properties:
        result:
          type: string
          example: success
        data:
          type: object
          properties:
            userCount:
              type: integer
              description: Number of unique users affected by this issue
              example: 17
            exceptionCount:
              type: integer
              description: Total number of times this exception occurred
              example: 19
            deviceCount:
              type: integer
              description: Number of unique devices affected by this issue
              example: 19
            appVersionCount:
              type: integer
              description: Number of distinct app versions in which this issue occurred
              example: 3
            issueCount:
              type: integer
              description: Number of unique issues (always 1 for a specific issueName)
              example: 1
        status:
          type: integer
          example: 2000
    crash_reports_response:
      type: object
      properties:
        result:
          type: string
          example: success
        data:
          type: object
          properties:
            reports:
              type: object
              description: Map of unique crash issues keyed by a crash identifier (prefix "crash+" followed by base64-encoded exception string).
              additionalProperties:
                type: object
                properties:
                  exceptionType:
                    type: string
                    description: Type of exception (e.g., native, java)
                    example: native
                  exception:
                    type: string
                    description: Full exception message and stack trace
                    example: "java.lang.IllegalArgumentException \tat com.zoho.apptics.GlobalKt.shareImage(Global.kt:236)"
                  exception_Base64:
                    type: string
                    description: Base64-encoded exception string
                    example: amF2YS5sYW5nLklsbGVnYWxBcmd1bWVudEV4Y2VwdGlvbiAJYXQgY29tLnpvaG8uYXBwdGljcy5HbG9iYWxLdC5zaGFyZUltYWdlKEdsb2JhbC5rdDoyMzYp
                  exception_UTF8:
                    type: string
                    description: URL-encoded UTF-8 representation of the exception string
                    example: java.lang.IllegalArgumentException+%09at+com.zoho.apptics.GlobalKt.shareImage%28Global.kt%3A236%29
                  exceptionCount:
                    type: integer
                    description: Total number of times this exception occurred
                    example: 8
                  deviceCount:
                    type: integer
                    description: Number of unique devices affected by this exception
                    example: 1
                  oses:
                    type: array
                    description: List of operating systems on which this exception occurred
                    items:
                      type: string
                    example:
                      - Android
                  pIDs:
                    type: array
                    description: List of project IDs associated with this exception
                    items:
                      type: integer
                    example:
                      - 5000015660033
                  appVersionsCount:
                    type: object
                    description: Breakdown of exception counts per app version, keyed by app version ID.
                    additionalProperties:
                      type: object
                      properties:
                        appVersion:
                          type: string
                          example: '1.17'
                        os:
                          type: string
                          example: Android
                        exceptionCount:
                          type: integer
                          example: 8
                        deviceCount:
                          type: integer
                          example: 1
                        pID:
                          type: integer
                          example: 5000015660033
                        crashGroup:
                          type: string
                          example: crash
                  status:
                    type: integer
                    example: 0
                  group:
                    type: string
                    description: Exception severity group (e.g., fatal, nonfatal)
                    example: fatal
                  exceptionGroup:
                    type: string
                    description: Exception category (e.g., crash, anr)
                    example: crash
            isNextIndexValuesAvailable:
              type: boolean
              description: Indicates whether more records are available. Pass the next index to retrieve the following page.
              example: false
        status:
          type: integer
          example: 2000
    crash_chart_data_response:
      type: object
      properties:
        result:
          type: string
          example: success
        data:
          type: object
          description: Chart data keyed by exception type (fatal, nonfatal, anr), then by platform (e.g., Android, iOS), then by metric.
          additionalProperties:
            description: Platform-level chart data for a given exception type
            type: object
            additionalProperties:
              type: object
              properties:
                crasheschart:
                  type: object
                  description: Time-series crash count. Keys are epoch timestamps in milliseconds for multi-day ranges, or hour numbers (0–23) for single-day ranges.
                  additionalProperties:
                    type: integer
                  example:
                    '1775327400000': 114
                    '1774981800000': 271
                deviceschart:
                  type: object
                  description: Time-series device count. Keys are epoch timestamps in milliseconds for multi-day ranges, or hour numbers (0–23) for single-day ranges.
                  additionalProperties:
                    type: integer
                  example:
                    '1775327400000': 61
                    '1774981800000': 84
                userschart:
                  type: object
                  description: Time-series user count. Keys are epoch timestamps in milliseconds for multi-day ranges, or hour numbers (0–23) for single-day ranges.
                  additionalProperties:
                    type: integer
                  example:
                    '1775327400000': 1
                    '1774981800000': 1
                issueschart:
                  type: object
                  description: Time-series issue count. Keys are epoch timestamps in milliseconds for multi-day ranges, or hour numbers (0–23) for single-day ranges.
                  additionalProperties:
                    type: integer
                  example:
                    '1775327400000': 48
                    '1774981800000': 53
        status:
          type: integer
          example: 2000
    crash_count_data_response:
      type: object
      properties:
        result:
          type: string
          example: success
        data:
          type: object
          properties:
            uniqueDevices:
              type: object
              description: Total unique device count for the selected period and the previous equivalent period.
              properties:
                count:
                  type: integer
                  description: Unique device count for the selected period
                  example: 204
                preCount:
                  type: integer
                  description: Unique device count for the previous equivalent period
                  example: 150
          additionalProperties:
            type: object
            description: Count data per exception type (anr, fatal, nonfatal)
            properties:
              countData:
                type: object
                description: Aggregated metrics for the selected period
                properties:
                  userCount:
                    type: integer
                    example: 192
                  exceptionCount:
                    type: integer
                    example: 218
                  deviceCount:
                    type: integer
                    example: 201
                  appVersionCount:
                    type: integer
                    example: 0
                  issueCount:
                    type: integer
                    example: 22
              preCountData:
                type: object
                description: Aggregated metrics for the previous equivalent period
                properties:
                  userCount:
                    type: integer
                    example: 129
                  exceptionCount:
                    type: integer
                    example: 189
                  deviceCount:
                    type: integer
                    example: 149
                  appVersionCount:
                    type: integer
                    example: 0
                  issueCount:
                    type: integer
                    example: 33
              exceptionFreeDevices:
                type: integer
                description: Percentage of devices that did not experience any exceptions in the selected period
                example: 69
              exceptionFreeUsers:
                type: integer
                description: Percentage of users that did not experience any exceptions in the selected period
                example: 69
        status:
          type: integer
          example: 2000
  securitySchemes:
    Zoho_Auth:
      type: oauth2
      flows:
        implicit:
          authorizationUrl: https://accounts.zoho.com/oauth/v2/auth
          scopes:
            JProxy.jmobileapi.ALL: Analytics & Insight view
