# Blackbird API – User Restaurant Memberships

> Blackbird API – User Restaurant Memberships 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 the authenticated user's per-restaurant membership records, including check-in counts and membership tiers, paginated and optionally filtered by restaurant.

## Facts

- Endpoint: GET https://the-stables-blackbird-api.vercel.app/api/users/me/memberships
- 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-user-restaurant-memberships-9080382b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vy-SIwtTKQ6LSdjK4REuV

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-user-restaurant-memberships-9080382b
```

Example prompt: Show me all my Blackbird restaurant memberships — I want to see my check-in counts and what tier I'm at for each place, starting from the first page.

## When to prefer this

Use this endpoint when you need to retrieve a Blackbird-authenticated user's loyalty membership data across one or all restaurants — specifically check-in counts and tier status. Prefer this over generic profile endpoints when the query is restaurant-specific loyalty data. If you only need the overall member profile (not per-restaurant breakdown), use the /users/me profile endpoint instead.

## Known failure modes

- Missing or invalid authentication (no JWT, no SIWX, wallet not linked) returns 401 Unauthorized
- Invalid restaurant UUID format returns 400 Bad Request
- Restaurant UUID not found or user has no membership there returns an empty results list
- Payment failure on first x402 call (insufficient USDC balance) returns 402 Payment Required
- page or page_size out of allowed range returns 400 Bad Request
- Expired or revoked JWT returns 401 Unauthorized

## How this service works

Your per-restaurant memberships — check-in counts and membership tiers. Requires a Blackbird identity: link your agent wallet once at /connect, then call with x402 + SIWX (first call pays, later SIWX-signed calls are free); or pass a member JWT in the X-Blackbird-Token header.

## Output

A paginated list of the authenticated user's restaurant memberships, each record containing the restaurant identifier, the user's accumulated check-in count at that restaurant, and their current membership tier. Supports page and page_size pagination controls and optional filtering by a specific restaurant UUID.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blackbird-api-user-restaurant-memberships-9080382b/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)