roic-ai · Schema

v3.IncomeStatementFinancialPeriodList

CompanyFinanceDataAPIStock

Properties

Name Type Description
data array
next_page_url object
previous_page_url object
View JSON Schema on GitHub

JSON Schema

roic-ai-v3-income-statement-financial-period-list-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/v3.IncomeStatementFinancialPeriodList",
  "title": "v3.IncomeStatementFinancialPeriodList",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/roic-ai-openapi.json#/components/schemas/v3.IncomeStatementFinancialPeriodList",
  "additionalProperties": false,
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "additionalProperties": false,
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "symbol": {
            "type": "string"
          },
          "period_type": {
            "type": "string",
            "enum": [
              "annual",
              "quarterly",
              "ttm"
            ]
          },
          "period_end_date": {
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "minLength": 10,
            "maxLength": 10,
            "type": "string"
          },
          "fiscal_year": {
            "anyOf": [
              {
                "anyOf": [
                  {
                    "format": "integer",
                    "default": 0,
                    "type": "string"
                  },
                  {
                    "type": "integer"
                  }
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "period_label": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "currency": {
            "type": "string"
          },
          "price_currency": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "fx_applied": {
            "type": "boolean"
          },
          "object": {
            "const": "v3.fundamentals.income_statement",
            "type": "string"
          },
          "is_sales_revenue_turnover": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_sales_and_services_revenues": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_cogs": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_cog_and_services_sold": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_gross_profit": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_other_oper_income": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_operating_expn": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_sg_and_a_expense": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_operating_expenses_r_and_d": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_other_operating_expenses": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_oper_income": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_nonop_income_loss": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_net_interest_expense": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_int_expense": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_int_income": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_other_nonop_income_loss": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_pretax_income": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_inc_tax_exp": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_inc_loss_affil": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_inc_bef_xo_item": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_xo_gl_net_of_tax": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_discontinued_operations": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_extraord_items_and_acctg_chng": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_ni_including_minority_int_ratio": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_min_noncontrol_interest_credits": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_net_income": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_tot_cash_pfd_dvd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_other_adjustments": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_earn_for_common": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_avg_num_sh_for_eps": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "eps": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "eps_cont_ops": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_sh_for_diluted_eps": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "diluted_eps": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "dil_eps_cont_ops": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "ebitda": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "ebitda_margin": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "ebita": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "ebit": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "gross_margin": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "oper_margin": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "profit_margin": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "actual_sales_per_empl": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "div_per_shr": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_depr_exp": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "symbol",
          "period_type",
          "period_end_date",
          "fiscal_year",
          "period_label",
          "currency",
          "price_currency",
          "fx_applied",
          "object",
          "is_sales_revenue_turnover",
          "is_sales_and_services_revenues",
          "is_cogs",
          "is_cog_and_services_sold",
          "is_gross_profit",
          "is_other_oper_income",
          "is_operating_expn",
          "is_sg_and_a_expense",
          "is_operating_expenses_r_and_d",
          "is_other_operating_expenses",
          "is_oper_income",
          "is_nonop_income_loss",
          "is_net_interest_expense",
          "is_int_expense",
          "is_int_income",
          "is_other_nonop_income_loss",
          "is_pretax_income",
          "is_inc_tax_exp",
          "is_inc_loss_affil",
          "is_inc_bef_xo_item",
          "is_xo_gl_net_of_tax",
          "is_discontinued_operations",
          "is_extraord_items_and_acctg_chng",
          "is_ni_including_minority_int_ratio",
          "is_min_noncontrol_interest_credits",
          "is_net_income",
          "is_tot_cash_pfd_dvd",
          "is_other_adjustments",
          "is_earn_for_common",
          "is_avg_num_sh_for_eps",
          "eps",
          "eps_cont_ops",
          "is_sh_for_diluted_eps",
          "diluted_eps",
          "dil_eps_cont_ops",
          "ebitda",
          "ebitda_margin",
          "ebita",
          "ebit",
          "gross_margin",
          "oper_margin",
          "profit_margin",
          "actual_sales_per_empl",
          "div_per_shr",
          "is_depr_exp"
        ],
        "$id": "#/components/schemas/v3.IncomeStatementFinancialPeriod"
      }
    },
    "next_page_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "previous_page_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "data",
    "next_page_url",
    "previous_page_url"
  ]
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/roic-ai-v3-income-statement-financial-period-list"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.