---
title: "Search financial statements"
method: POST
path: "/financials/search/screener"
tags: ["Financial Statements"]
---

# Search financial statements

`POST /financials/search/screener`

Search for stocks by filtering across financial metrics from income statements, balance sheets, and cash flow statements.

## Request body

- SearchFiltersRequest
  - `limit` integer — The maximum number of results to return.
  - `filters` object[], required — An array of filter objects to apply to the search.
    - `field` string, required — The criteria to filter on. For financial metric fields, use 'gt', 'lt', 'gte', 'lte', 'eq' operators. For 'ticker' and 'cik' fields, use the 'in' operator to filter against multiple values.
    - `operator` 'gt' | 'lt' | 'gte' | 'lte' | 'eq' | 'in', required — The comparison operator. The 'in' operator can only be used with a field value of 'ticker' or 'cik' and lets you filter against multiple values.
    - `value` union, required
      - number — The value to compare against for single-value operators (gt, lt, gte, lte, eq)
      - string[] — Array of ticker or cik values to compare against when using the 'in' operator

## Response `200`

Successful search response

- FinancialsSearchResponse
  - `search_results` object[]
    - `ticker` string — The ticker symbol of the company.
    - `report_period` string, date — The reporting period of the financial data.
    - `period` 'annual' | 'quarterly' | 'ttm' — The time period of the financial data.
    - `currency` string — The currency of the financial data.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `402` — The request requires a paid subscription
- `404` — The specified resource was not found

---

[API](https://skmtc.net/financialdatasets/apis/financial-datasets-api.md) · [All operations](https://skmtc.net/financialdatasets/apis/financial-datasets-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/financialdatasets/financial-datasets-api/revisions/df2363101891/schema)