{"uid":"cap_EQM0qT0YjkMHEjecXGLqM","slug":"agentic-reservations-list-restaurant-reservations-resy-f24adae9","name":"Agentic Reservations — List Restaurant Reservations (Resy)","description":"API that lets AI agents search and book restaurant reservations on Resy. Pay $0.10 USDC per booking with a crypto wallet.","url":"https://agentic-reservations.vercel.app/api/reservations","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"type":{"enum":["upcoming","past"],"type":"string","default":"upcoming","description":"Which reservations to list"},"limit":{"type":"integer","default":10,"maximum":50,"minimum":1},"offset":{"type":"integer","default":0,"minimum":0}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"type":{"enum":["upcoming","past"],"type":"string"},"limit":{"type":"integer"},"total":{"type":"integer"},"offset":{"type":"integer"},"reservations":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string","format":"date"},"venue":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"rating":{"type":"number","nullable":true},"cuisine":{"type":"string","nullable":true},"address_1":{"type":"string","nullable":true},"neighborhood":{"type":"string","nullable":true}}},"num_seats":{"type":"integer"},"time_slot":{"type":"string"},"resy_token":{"type":"string","description":"Pass to POST /api/cancel to cancel this reservation"},"config_type":{"type":"string"},"reservation_id":{"type":"integer"}}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","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":"free","summary":"Free","primary":{"kind":"free","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"free","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_06msi8CaGY4QgzK39ScOd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a paginated list of upcoming or past restaurant reservations for an AI agent via the Resy platform","exampleAgentPrompt":"Can you pull up my upcoming Resy restaurant reservations — show me the next 10 bookings I have scheduled?","exampleUseCases":[{"title":"Check upcoming dining bookings","prompt":"What restaurant reservations do I have coming up on Resy? Show me the next 10 so I can see where I'm eating this month."},{"title":"Review past reservation history","prompt":"Can you look up my past restaurant reservations on Resy — show me the most recent 20 so I can remember where I've dined."},{"title":"Find token to cancel a reservation","prompt":"I need to cancel one of my upcoming Resy reservations — can you list my upcoming bookings so I can find the right one and get its cancellation token?"}],"resultDescription":"Returns a paginated object containing the reservation type (upcoming or past), total count, limit, offset, and an array of reservation objects. Each reservation includes the date, time slot, number of seats, config type, a resy_token (usable to cancel via POST /api/cancel), and venue details including name, rating, cuisine type, address, and neighborhood.","failureModes":["Invalid type enum value (not 'upcoming' or 'past') returns a validation error","Limit exceeding 50 returns a validation error","Offset out of range returns an empty reservations array","Missing or invalid authentication credentials returns 401 Unauthorized","Resy API unavailability causes upstream 503 errors","Payment/wallet issues may prevent access if the x402 payment layer is invoked"],"whenToPreferThis":"Use this endpoint when an AI agent needs to retrieve a user's existing Resy restaurant reservations — either upcoming or historical. It is the correct choice when the agent needs reservation details (time, venue, seats) or the resy_token needed to cancel a booking. Prefer this over booking endpoints when the goal is to read or audit reservations rather than create new ones.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:35:19.704Z","isFirstParty":false}