---
title: "Save Screener Filter"
method: POST
path: "/api/saved-screeners"
tags: ["saved-screeners"]
---

# Save Screener Filter

`POST /api/saved-screeners`

## Request

- Base URL: `https://api.equity-rank.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.equity-rank.com/api/saved-screeners`
- Auth: HTTP bearer

Save a new screener filter set. Max 10 per user.

## Request body

- SaveFilterRequest
  - `name` string, required
  - `filters` ScreenerFilters, required
    - `sector` string, nullable
    - `min_score` number
    - `sort_by` string
    - `min_piotroski_score` integer, nullable
    - `graham_below_price` boolean
    - `max_illiquidity_premium` number, nullable
    - `min_roic` number, nullable
    - `min_gross_margin` number, nullable
    - `min_net_margin` number, nullable
    - `min_revenue_growth` number, nullable
    - `min_eps_growth` number, nullable
    - `min_fcf_yield` number, nullable
    - `max_net_debt_to_ebitda` number, nullable

## Response `201`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/equity-rank/apis/equity-rank-api.md) · [All operations](https://skmtc.dev/equity-rank/apis/equity-rank-api/llms.txt) · [OpenAPI document](https://skmtc.dev/equity-rank/apis/equity-rank-api/revisions/c2f2463fee33?raw)
