---
title: "Fails to Deliver Ranking"
method: GET
path: "/fails-to-deliver/ranking"
tags: ["Short Interest"]
---

# Fails to Deliver Ranking

`GET /fails-to-deliver/ranking`

## Request

- Base URL: `https://api.dataporium.io`
- URL: `https://api.dataporium.io/fails-to-deliver/ranking`
- Auth: API key in query parameter `apikey`

Securities ranked by their fails to deliver in one half-month (default the newest), by value or by shares, with days with fails, averages, the largest day, the longest run of large fails and the flagged mark. Give symbol=A,B,C to get the rows of chosen tickers, for example as a column next to another list.

The answer is {period, total, limit, offset, sort, order, rows, about, period_about}. A sort value outside the list returns an error that names the allowed values.

## Query parameters

- `period` string
- `symbol` string
- `q` string
- `listed_only` boolean
- `flagged_only` boolean
- `min_value` number
- `min_quantity` integer
- `sort` string
- `order` string
- `limit` integer
- `offset` integer

## Response `200`

Successful response (JSON).

- object

## Other responses

- `401`: No API key in the request.
- `403`: The API key is not valid or has expired.

---

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