---
title: "Filter and sort every covered company (about 850) on published numbers"
method: GET
path: "/api/v1/screen"
---

# Filter and sort every covered company (about 850) on published numbers

`GET /api/v1/screen`

## Request

- Base URL: `https://oqro.io`
- URL: `https://oqro.io/api/v1/screen`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Filter and sort every covered company (about 850) on published numbers. All filters combine with AND; a company with no figure for a filtered number is left out, never counted as zero.

## Query parameters

- `sector` string
- `min_market_value` number
- `max_market_value` number
- `min_change_12m` number
- `max_change_12m` number
- `min_vs_sp500_12m` number
- `max_vs_sp500_12m` number
- `within_pct_of_12m_high` number
- `at_least_pct_below_12m_high` number
- `min_insider_purchases_90d` integer
- `min_congress_purchases_90d` integer
- `min_fund_adds_180d` integer
- `has_federal_contracts_90d` boolean
- `profitable` boolean
- `positive_free_cash_flow` boolean
- `net_cash` boolean
- `min_days_to_cover` number
- `sort_by` string
- `direction` string
- `limit` integer
- `cursor` string

## Response `200`

JSON: { data, pagination?, meta? }. Every row links its official source.

- object
  - `data` unknown, required
  - `pagination` object
  - `meta` object

## Other responses

- `400`: invalid_parameter
- `401`: missing_api_key or invalid_api_key
- `402`: The key's owner has no OQRO Pro
- `404`: ticker_not_covered
- `429`: rate_limited: 60 requests a minute and 5,000 a day per key

---

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