List specials
curl --request GET \
--url https://api.staging.blackbird.xyz/flynet/v1/specialsconst options = {method: 'GET'};
fetch('https://api.staging.blackbird.xyz/flynet/v1/specials', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {method: 'GET'};
fetch('https://api.staging.blackbird.xyz/flynet/v1/specials', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Specials
List specials
GET
/
specials
List specials
curl --request GET \
--url https://api.staging.blackbird.xyz/flynet/v1/specialsconst options = {method: 'GET'};
fetch('https://api.staging.blackbird.xyz/flynet/v1/specials', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {method: 'GET'};
fetch('https://api.staging.blackbird.xyz/flynet/v1/specials', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));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
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
{
"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. |