{"uid":"cap_YMLbbyE_1DZZAKXdOxBzk","slug":"blackbird-api-list-restaurant-specials-95edd56d","name":"Blackbird API – List Restaurant Specials","description":"List a restaurant's specials — limited menu items or offers, optionally carrying a FLY reward and check-in threshold.","url":"https://the-stables-blackbird-api.vercel.app/api/specials","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_6XJbHppL1m4Ra8Kxtmuxm","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 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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Checking rewards before dining","prompt":"Before I head out tonight, can you check what specials and FLY reward deals are currently running at restaurant 3f6c2a1b-4e8d-4b2a-9c5e-1234567890ab on Blackbird so I know what to order?"},{"title":"Discovering check-in threshold offers","prompt":"I've been checking in at this Blackbird restaurant a lot — pull up their specials list for restaurant UUID 9a1b2c3d-5e6f-7a8b-9c0d-abcdef012345 and show me if any require a certain number of check-ins to unlock."},{"title":"Browsing limited menu promotions","prompt":"What limited menu items or promotional specials does restaurant 7d8e9f0a-1b2c-3d4e-5f6a-789012345678 have on Blackbird right now? Show me the first page of results."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:31:58.150Z","isFirstParty":false}