{"uid":"cap_10lpqncmBpqLGLsBPH7Zl","slug":"agentic-reservations-resy-restaurant-booking-via-x402-5d93bc76","name":"Agentic Reservations — Resy Restaurant Booking via x402","description":"Create a paid reservation job that books a hard-to-get Resy table the moment its booking window opens. Failed or duplicate enqueues are refunded.","url":"https://agentres.dev/api/reservation-jobs/create","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"venue_id":{"type":"string","description":"Venue id from /api/reservation-jobs/options. Provide venue_id or restaurant."},"party_size":{"type":"integer","maximum":20,"minimum":1},"restaurant":{"type":"string","description":"Restaurant name to resolve against the supported list. Provide venue_id or restaurant."},"preferred_hour":{"type":"integer","default":18,"maximum":23,"minimum":0},"preferred_minute":{"type":"integer","default":0,"maximum":59,"minimum":0},"reservation_date":{"type":"string","format":"date","description":"Desired reservation date (YYYY-MM-DD)"}}},"responseSchema":{"type":"json","example":{"job_id":"0a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9","status":"queued","venue_id":"834","charge_id":"9f8e7d6c-5b4a-3928-1706-f5e4d3c2b1a0","drop_time":"2026-07-15T13:00:00Z","party_size":2,"restaurant_name":"4 Charles Prime Rib","reservation_date":"2026-08-14"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"3","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":"$3/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"3","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"3","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bXJFF97zgUwXVG3bKTDzC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"3","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates a restaurant reservation booking job on Resy for a specified venue, date, party size, and drop time, paid via USDC crypto wallet","exampleAgentPrompt":"Book me a table for 2 at 4 Charles Prime Rib on August 14th — set the drop time to July 15th at 1pm and pay with my USDC wallet.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a job_id (UUID), a status field set to 'queued', the venue_id, charge_id for the USDC payment, the scheduled drop_time, party_size, restaurant_name, and reservation_date confirming the booking job was created.","failureModes":["Insufficient USDC balance in wallet — payment fails and job is not created","Invalid venue_id — Resy venue not found or not supported","Requested reservation date or time not available","Malformed drop_time or reservation_date format","Missing required fields (venue_id, party_size, reservation_date) — 400 error","Resy API unavailable or rate-limited — upstream failure"],"whenToPreferThis":"Use this endpoint when an AI agent needs to autonomously book restaurant reservations on Resy and can pay via USDC crypto (x402 protocol). Prefer this over manual booking flows when automating dining reservations, especially for hard-to-get tables that require precise drop-time scheduling. Best suited for agents with a crypto wallet and a user who wants hands-off restaurant booking.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:46:33.195Z","isFirstParty":false}