{"uid":"cap_VTiR1SZX-vkwbWU-Prb91","slug":"agentic-reservations-list-resy-reservations-58cce2a6","name":"Agentic Reservations — List Resy 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://www.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":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_U3J9-dvjIU9Tx6NKBV_FP","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 from the authenticated user's Resy account, including venue details, time slots, and cancellation tokens.","exampleAgentPrompt":"Show me my next 10 upcoming Resy reservations, including the restaurant name, cuisine, neighborhood, and what time slot I booked.","exampleUseCases":[{"title":"Confirm dinner plans before travel","prompt":"I have a trip coming up next month—pull up my upcoming Resy reservations so I can see which restaurants I've booked and make sure I haven't double-booked any nights."},{"title":"Cancel and rebook conflicting reservations","prompt":"Check my reservations for the next two weeks and show me the cancellation tokens for any that overlap with my work meetings, so I can cancel them and find new times."},{"title":"Track dining history for expense reports","prompt":"Show me all the restaurant reservations I made in the past three months with the venue names and dates—I need to document them for my business expenses."}],"resultDescription":"A JSON object containing a paginated list of reservations with type (upcoming/past), total count, limit, and offset, plus an array of reservation objects — each with date, venue info (name, rating, cuisine, address, neighborhood), number of seats, time slot, config type, reservation ID, and a resy_token that can be passed to the cancel endpoint.","failureModes":["No reservations found — returns empty array with total: 0","Authentication failure — user's Resy credentials not linked or session expired","Invalid 'type' parameter value — must be 'upcoming' or 'past'","Limit out of range — must be between 1 and 50","Offset out of range — must be 0 or greater","Upstream Resy API unavailable — service temporarily down"],"whenToPreferThis":"Use this endpoint when you need to inspect, display, or act upon a user's existing Resy reservation history — especially when you need resy_token values to subsequently cancel reservations or when you want to confirm an upcoming booking exists before taking action.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:33:41.396Z","isFirstParty":false}