---
title: "GET /reports/financialRatios"
method: GET
path: "/reports/financialRatios"
tags: ["Reports"]
---

# GET /reports/financialRatios

`GET /reports/financialRatios`

## Request

- Base URL: `https://api.railz.ai`
- URL: `https://api.railz.ai/reports/financialRatios`
- Auth: HTTP bearer

API to retrieve formatted financial ratios report

## Query parameters

- `businessName` string, required
- `serviceName` 'freshbooks' | 'quickbooks' | 'quickbooksDesktop' | 'xero' | 'oracleNetsuite' | 'sageBusinessCloud' | 'sageIntacct' | 'dynamicsBusinessCentral' | 'zohoBooks' | 'byod', 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

## Changes

- **2026-08-10** `5cdfae3fa1fa`: 4 breaking, 14 warning, 2 info
  - removed the enum value `myob` from the `query` request parameter `serviceName`
  - removed the enum value `sandbox` from the `query` request parameter `serviceName`
  - removed the enum value `wave` from the `query` request parameter `serviceName`
  - removed the required property `meta/currency` from the response with the `200` status
  - …16 more

[Operation history](https://skmtc.dev/railz/apis/fis-accounting-data-as-a-service-api/changes/reports/financialRatios/get.md)

---

[API](https://skmtc.dev/railz/apis/fis-accounting-data-as-a-service-api.md) - [All operations](https://skmtc.dev/railz/apis/fis-accounting-data-as-a-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/railz/apis/fis-accounting-data-as-a-service-api/revisions/1383b9a47ac9?raw)