> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flynet.org/llms.txt
> Use this file to discover all available pages before exploring further.

# List specials

Lists restaurant specials — limited offers and menu highlights. A special can
optionally carry a FLY reward (`fly_reward` or `fly_reward_bips`) and a
`check_in_threshold` a member must reach to earn it.

Pass the `restaurant` UUID you want specials for (required).

Auth: API key in `X-API-Key`. The key must carry the `read:restaurant_specials`
scope.

## Example

```bash theme={null}
curl "https://api.staging.blackbird.xyz/flynet/v1/specials?restaurant=14339db3-2e7a-42c4-aa98-4c0fb18679eb&page=0&page_size=50" \
  -H "X-API-Key: $API_KEY"
```

## Response

```json theme={null}
{
  "specials": [
    {
      "id": "5d4c3b2a-1908-4716-8a5b-4c3d2e1f0a9b",
      "object": "special",
      "restaurant_id": "14339db3-2e7a-42c4-aa98-4c0fb18679eb",
      "label": "Happy Hour",
      "description": "Half-price oysters, 5–7pm.",
      "emoji": "🦪",
      "image": null,
      "fly_reward": { "value": "500000000000000000", "currency": "FLY" },
      "fly_reward_bips": null,
      "check_in_threshold": null,
      "created_at": "2026-06-01T00:00:00Z",
      "updated_at": "2026-06-01T00:00:00Z"
    }
  ],
  "pagination": {
    "total_count": 1,
    "total_pages": 1,
    "current_page": 0,
    "next_page": null,
    "page_size": 50
  }
}
```

| Field                | Type    | Notes                                                          |
| -------------------- | ------- | -------------------------------------------------------------- |
| `label`              | string  | Short title for the special.                                   |
| `emoji`              | string  | A single emoji for the special.                                |
| `fly_reward`         | object  | FLY reward, if the special carries one (smallest-unit string). |
| `fly_reward_bips`    | integer | Reward as basis points of spend, if applicable.                |
| `check_in_threshold` | integer | Check-ins required to earn the reward, if applicable.          |