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

# Search financial statements

`POST /financials/search/screener`

## Request

- Base URL: `https://api.financialdatasets.ai`
- URL: `https://api.financialdatasets.ai/financials/search/screener`
- Auth: API key in header `X-API-KEY`

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 field to filter on: a financial statement or financial metrics field, sector, industry, or ticker. Numeric fields take gt, lt, gte, lte, eq and in (a list of numbers). sector, industry and ticker take eq and in (a list of strings).
    - `operator` 'gt' | 'lt' | 'gte' | 'lte' | 'eq' | 'in', required: The comparison operator. in takes a list in value and works on every field.
    - `value` union, required
      - number: The value to compare against for gt, lt, gte, lte and eq on a numeric field.
      - string: The value to compare against for eq on sector, industry or ticker. Sector and industry values are case-insensitive.
      - union[]: The list of values for the in operator.
        - union
          - number
          - string
  - `currency` string: The currency of the statement values to screen. Defaults to USD.
  - `order_by` object: Sort the matches before the limit applies. Without it, results come back sorted by ticker. The sort field is added to every result row.
    - `field` string, required: A numeric filter field to sort by, for example market_cap. Sector, industry and ticker cannot be sorted on.
    - `direction` 'asc' | 'desc': Sort direction. Companies with no value for the field come last either way.
  - `as_of` string, date: Point-in-time screen for backtests: screen on the newest filing each company had made public on or before this date (YYYY-MM-DD). Without it, the screen uses today's latest data. The date must be between coverage_start (2010-03-01) and today. stock_price is not available with as_of.

## Response `200`

Successful search response

- FinancialsScreenerResponse
  - `results` object[]: The companies that match every filter, sorted by ticker, or by order_by when given.
    - `ticker` string: The ticker symbol of the company.
    - `report_period` string, date: The period end of the matched statement data. Companies whose latest period is more than 180 days before the screen date are left out.
    - `currency` string: The currency of the monetary values.
    - `filing_date` string, date: With as_of only: the date the matched filing became public. Always on or before as_of.
    - `sector` string, nullable: GICS sector of the company.
    - `industry` string, nullable: GICS industry of the company.
  - `as_of` string, date: With as_of only: the date the screen was run as of, echoed back.
  - `coverage_start` string, date: With as_of only: the earliest date a point-in-time screen can be run for.

## Other responses

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

## Changes

- **2026-11-04** `42ba45d24472`: 9 info
  - added the new optional request property `as_of`
  - added the new optional request property `currency`
  - added the new optional request property `order_by`
  - request property `filters/items/value` list-of-types was widened by adding types `string` to media type `application/json`
  - …5 more
- **2026-11-04** `b87ad499e870`: 1 warning, 1 info
  - removed the optional property `search_results` from the response with the `200` status
  - added the optional property `results` to the response with the `200` status

[Operation history](https://skmtc.dev/financialdatasets/apis/financial-datasets-api/changes/financials/search/screener/post.md)

---

[API](https://skmtc.dev/financialdatasets/apis/financial-datasets-api.md) - [All operations](https://skmtc.dev/financialdatasets/apis/financial-datasets-api/llms.txt) - [OpenAPI document](https://skmtc.dev/financialdatasets/apis/financial-datasets-api/revisions/42ba45d24472?raw)