---
title: "Get Screen"
method: GET
path: "/screen"
---

# Get Screen

`GET /screen`

## Request

- Base URL: `https://sec.multyplylabs.com`
- URL: `https://sec.multyplylabs.com/screen`
- Auth: API key in header `X-API-Key`

Stock screener over normalized SEC fundamentals: filter US public companies by any combination of financial metrics for a fiscal year (e.g. gross_margin > 0.6 AND revenue > 1e9). Returns the matching companies with names, tickers, industries and their metric values. Use it to build a candidate list from scratch; the /insight routes rank pre-built ones.

## Query parameters

- `fy` integer, required
- `filters` string, required: JSON list of [metric, op, value], e.g. [["gross_margin",">",0.6],["revenue",">",1e9]]
- `limit` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `402`: Payment required: the request carried neither a valid API key nor a payment. The x402 v2 challenge is base64-encoded JSON in the PAYMENT-REQUIRED header (decoded in the example below); the response body itself is empty. Pay it in USDC on Base, or send an API key.
- `422`: Validation Error

---

[API](https://skmtc.dev/multyplylabs/apis/sec-fundamentals-api.md) · [All operations](https://skmtc.dev/multyplylabs/apis/sec-fundamentals-api/llms.txt) · [OpenAPI document](https://skmtc.dev/multyplylabs/apis/sec-fundamentals-api/revisions/9144596a4119?raw)