---
title: "List Financial Ratios report"
method: GET
path: "/v2/visualizations/financialRatios"
tags: ["Visualizations"]
---

# List Financial Ratios report

`GET /v2/visualizations/financialRatios`

**Supported for:**

`freshbooks` `quickbooks` `quickbooksDesktop` `xero` `dynamicsBusinessCentral` `zohoBooks` `byod`

## Query parameters

- `connectionUuid` string, required
- `startDate` string, required
- `endDate` string, required
- `reportFrequency` 'month' | 'quarter' | 'year', required

## Response `200`

Successfully returned financial ratios

- object
  - `meta` object, required
    - `reportId` string[], required
    - `serviceName` 'freshbooks' | 'quickbooks' | 'quickbooksDesktop' | 'xero' | 'oracleNetsuite' | 'sageBusinessCloud' | 'sageIntacct' | 'dynamicsBusinessCentral' | 'dynamics365Finance' | 'wave' | 'myob' | 'zohoBooks' | 'byod', required
    - `businessName` string, required
    - `endDate` string, required — if report frequency is monthly, end date is maximum of 12 months from start date, if quaterly, its a maximum of 3 years from start date, if yearly, its maximum of 12 years from start date
    - `startDate` string, required
    - `reportFrequency` 'month' | 'quarter' | 'year', required
  - `data` object, required
    - `credit` object
      - `distanceToDefault` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `probabilityOfDefault` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `liquidationValue` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
    - `efficiency` object
      - `grossBurnRate` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `inventoryTurnoverRatio` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `assetTurnoverRatio` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
    - `leverage` object
      - `equityToLTAssets` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `shortDebtToEquityRatio` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `debtToEquityRatio` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `interestBankLoan` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `interestCoverageRatio` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `debtToAssetsRatio` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `debtServiceCoverageRatio` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
    - `liquidity` object
      - `quickRatio` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `absoluteLiquidity` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `currentRatio` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `grossBurn` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `runway` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `cashRatio` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `freeCashflowRatio` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
    - `profitability` object
      - `returnOnAssets` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `ebitda` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `ebitdaMargin` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `workingCapital` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `freeCashFlow` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `grossMargin` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `netProfitMargin` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `operatingMargin` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `returnOnEquity` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required
      - `revenueConcentrationIndex` object
        - `currentValue` number, double, required — Return on Assets - EBITDA calculation (a decimal value)
        - `percentageChange` number, double, required — EBITDA (a dollar value)
        - `timePeriodData` object[], required
          - `period` object, required
            - `year` number, required
            - `month` number, required
            - `quarter` number, required
            - `day` number, required
            - `date` string, required
          - `value` number, required

## Other responses

- `202` — Data in pending state
- `204` — No data available
- `400` — Bad Request Error - Thrown if fields sent via query does not follow specifications
- `401` — Unauthorized - Not logged in or log in expired
- `403` — Forbidden - Not enough permission
- `500` — Server Error

---

[API](https://skmtc.net/railz/apis/fis-accounting-data-as-a-service-api.md) · [All operations](https://skmtc.net/railz/apis/fis-accounting-data-as-a-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/railz/fis-accounting-data-as-a-service-api/revisions/5cdfae3fa1fa/schema)