{"uid":"cap_yVOq-jWUhiCJiEVPXocFz","slug":"agentic-reservations-list-restaurant-reservations-98d13497","name":"Agentic Reservations — List Restaurant Reservations","description":"API that lets AI agents search and book restaurant reservations on Resy. Pay $0.01 USDC per booking with a crypto wallet.","url":"https://agentres.dev/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":{"type":"json","example":{"type":"upcoming","limit":10,"total":1,"offset":0,"reservations":[{"day":"2026-05-01","venue":{"id":6194,"name":"Carbone","rating":4.7,"cuisine":"Italian","address_1":"181 Thompson St","neighborhood":"Greenwich Village"},"num_seats":2,"time_slot":"19:00:00","resy_token":"abc123token","config_type":"Dining Room","reservation_id":987654}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":1,"rating":{"score":"1.00","successRate":"1.00","reviews":1,"stars":"5.0","state":"rated"},"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_aoEXBktrcnbWLZa3NhLF5","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 the authenticated agent via Resy.","exampleAgentPrompt":"Show me my upcoming restaurant reservations on Resy — list the next 10 so I can see where I'm eating and when.","exampleUseCases":null,"resultDescription":"A JSON object containing a paginated list of reservations (upcoming or past), each with venue name, cuisine, address, neighborhood, star rating, date, time slot, party size, config type, reservation ID, and a resy_token usable for cancellation. Also includes total count, limit, and offset for pagination.","failureModes":["No authenticated Resy account connected — returns auth error","Invalid type enum value (not 'upcoming' or 'past') — returns validation error","Limit out of range (>50 or <1) — returns validation error","No reservations found — returns empty reservations array with total: 0","Offset beyond total — returns empty reservations array"],"whenToPreferThis":"Use this endpoint when you need to list or review existing restaurant reservations for a user — whether upcoming or historical — especially when you need the resy_token to perform a subsequent cancellation. Prefer this over a search/availability endpoint when the goal is to inspect already-booked reservations rather than find new ones.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":2,"lastUsedAt":"2026-07-28T02:28:36.927Z","lastSuccessfullyRanAt":"2026-07-28T02:28:36.927Z","lastHealthCheckAt":"2026-09-14T18:40:58.308Z","isFirstParty":false}