# Blackbird API – List Restaurant Specials

> Blackbird API – List Restaurant Specials is a paid API for AI agents from the-stables-blackbird-api.vercel.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns a paginated list of a restaurant's current specials — limited menu items or promotional offers, optionally carrying a FLY reward and check-in threshold requirement.

## Facts

- Endpoint: GET https://the-stables-blackbird-api.vercel.app/api/specials
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blackbird-api-list-restaurant-specials-95edd56d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YMLbbyE_1DZZAKXdOxBzk

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blackbird-api-list-restaurant-specials-95edd56d
```

Example prompt: Can you pull up the current specials at The Stables restaurant on Blackbird — I want to see if any have FLY rewards attached? The restaurant ID is 3f6c2a1b-4e8d-4b2a-9c5e-1234567890ab.

## When to prefer this

Use this endpoint when you need to display or inspect the current specials, limited offers, or FLY reward promotions for a specific Blackbird-registered restaurant. Prefer this over the challenges endpoint when the user is interested in browsing what discounts or menu specials are available today rather than ongoing reward campaigns tied to actions like referrals or dines.

## Known failure modes

- Invalid or malformed restaurant UUID returns a 400 or 422 validation error
- Restaurant UUID not found returns a 404 not found error
- Page number out of range returns an empty results list or error
- Missing required restaurant parameter returns a validation error
- Payment not fulfilled (x402) causes a 402 Payment Required response

## How this service works

List a restaurant's specials — limited menu items or offers, optionally carrying a FLY reward and check-in threshold.

## Output

A paginated list of specials for the specified restaurant, each special including details such as the offer description, any associated FLY reward amount, and the check-in count threshold required to access the special.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blackbird-api-list-restaurant-specials-95edd56d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from the-stables-blackbird-api.vercel.app](https://www.zero.xyz/host/the-stables-blackbird-api.vercel.app/llms.txt)