---
title: "Live award drops, ranked"
method: GET
path: "/drops"
---

# Live award drops, ranked

`GET /drops`

## Request

- Base URL: `https://www.awardclaw.com/api/v1`
- URL: `https://www.awardclaw.com/api/v1/drops`
- Auth: HTTP bearer

## Query parameters

- `origin` string: 3-letter airport code(s), comma-separated
- `destination` string: 3-letter airport code(s), comma-separated
- `cabin` 'business' | 'first'
- `max_miles` integer
- `round_trip` boolean
- `limit` integer

## Response `200`

Drops

- object
  - `total` integer
  - `drops` Drop[]
    - `id` string
    - `url` string
    - `origin` string
    - `destination` string
    - `cabin` 'Business' | 'First'
    - `airlines` string, nullable
    - `round_trip` boolean
    - `best_miles` integer, nullable
    - `summary` string, nullable
    - `programs` string[]
    - `outbound` object
      - `date_range` string, nullable
      - `dates` DropDate[]
        - `date` string, date
        - `miles` integer
        - `seats` integer, nullable
        - `taxes_usd` number, nullable
        - `program` string
        - `program_name` string
        - `airlines` string, nullable
        - `booking_url` string, nullable
    - `return` object, nullable
      - `date_range` string, nullable
      - `dates` DropDate[]
        - `date` string, date
        - `miles` integer
        - `seats` integer, nullable
        - `taxes_usd` number, nullable
        - `program` string
        - `program_name` string
        - `airlines` string, nullable
        - `booking_url` string, nullable
    - `detected_at` string, date-time
    - `last_seen_at` string, date-time, nullable
    - `score` integer

---

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