{"uid":"cap_vy-SIwtTKQ6LSdjK4REuV","slug":"blackbird-api-user-restaurant-memberships-9080382b","name":"Blackbird API – User Restaurant Memberships","description":"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.","url":"https://the-stables-blackbird-api.vercel.app/api/users/me/memberships","method":"GET","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8YQ5rTUz-DWZH7cGkuZXm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the authenticated user's per-restaurant membership records, including check-in counts and membership tiers, paginated and optionally filtered by restaurant.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Check loyalty tier at a specific venue","prompt":"What's my current Blackbird membership tier and check-in count at the restaurant with ID a3f2c1d0-beef-4abc-9001-123456789abc?"},{"title":"Browse all my restaurant memberships","prompt":"List all the restaurants I'm a member of on Blackbird — show me my tiers and how many times I've checked into each one, 50 per page."},{"title":"Verify membership status before visiting","prompt":"Am I a Blackbird member at The Stables, and if so, what tier am I on? I want to know before I head there tonight."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:38:25.571Z","isFirstParty":false}