---
title: "Screen the market (paid, top 20 rows)"
method: GET
path: "/api/v1/screen"
---

# Screen the market (paid, top 20 rows)

`GET /api/v1/screen`

## Request

- Base URL: `https://dilutionlens.com`
- URL: `https://dilutionlens.com/api/v1/screen`
- Auth: API key in header `x-api-key`

Filter and sort the universe by dilution risk, cash cover band, market-cap band, industry or name. Returns at most 20 rows — always the TOP rows of the requested ordering; there is no offset paging on this endpoint (an explicit offset, or a limit above 20, is ignored and reported in the response's ignored list). A discovery tool, not an extract. Query parameters match the public screener's URL vocabulary: q, risk, cover, cap, industry, suspended, sort, dir. Companies suspended from official quotation are EXCLUDED by default, exactly as on the website; the response's suspended_hidden says how many this query withheld, and suspended=include returns them.

## Query parameters

- `q` string
- `risk` string
- `cover` string
- `cap` string
- `industry` string
- `suspended` string
- `sort` string
- `dir` string

## Response `200`

Up to 20 matching rows, the honest total, and suspended_hidden — the number of suspended companies this query withheld.

- object

## Other responses

- `400`: Unknown ticker, unknown section, or a bulk-shaped request (error code per_ticker_only, answered with the professional contact address).
- `401`: Missing, unknown or revoked API key. The body carries an error code (auth_required | invalid_key).
- `402`: This endpoint is part of a paid plan (error code unlock_required). Plans: https://dilutionlens.com/pricing/
- `429`: The shared per-account budget (or the free daily cap) is spent. Hourly budgets reset at the top of the hour; the free cap resets at midnight UTC.

---

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