# Blackbird API – List Restaurant Challenges

> Blackbird API – List Restaurant Challenges 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).

Retrieves a paginated list of FLY reward challenges for a given restaurant, including campaigns completed via payments, referrals, dines, or passport milestones.

## Facts

- Endpoint: GET https://the-stables-blackbird-api.vercel.app/api/challenges
- 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-challenges-44d125e4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qvkOYKNv85OHurigbZgVP

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-challenges-44d125e4
```

Example prompt: Can you pull up all the Blackbird FLY reward challenges for my restaurant — the UUID is 3fa85f64-5717-4562-b3fc-2c963f66afa6?

## When to prefer this

Use this endpoint when you need to discover and display what FLY reward challenges a specific restaurant has configured on the Blackbird loyalty platform, especially for building loyalty dashboards, guest-facing reward discovery features, or restaurant management tools. Prefer this over the specials endpoint when the goal is campaign/milestone data rather than menu offers.

## Known failure modes

- Missing or invalid restaurant UUID returns a 400 or 422 validation error
- Non-existent restaurant UUID returns an empty list or 404
- Invalid location UUID format returns a validation error
- Page number out of range returns an empty results set
- Authentication or x402 payment failure returns 402 Payment Required
- Rate limiting or server errors return 5xx responses

## How this service works

List a restaurant's challenges — FLY reward campaigns completed by payments, referrals, dines, or passport milestones.

## Output

A paginated list of challenge objects for the specified restaurant, each describing a FLY reward campaign (type: payment, referral, dine, or passport milestone), including campaign details, milestones, and reward amounts. Supports filtering by location UUID and pagination via page and page_size parameters.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blackbird-api-list-restaurant-challenges-44d125e4/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)