List specials

curl --request GET \
  --url https://api.staging.blackbird.xyz/flynet/v1/specials

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));

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));

GET

specials

List specials

curl --request GET \
  --url https://api.staging.blackbird.xyz/flynet/v1/specials

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));

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.

List challenges List memberships

​Example

​Response

Example

Response