{"uid":"cap_sgAFxeN_AIq_qxgo16mfj","slug":"agentic-reservations-list-reservation-jobs-584bf050","name":"Agentic Reservations — List Reservation Jobs","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/reservation-jobs","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":{"limit":{"type":"integer","default":10,"maximum":100,"minimum":1},"status":{"enum":["queued","running","cancel_requested","succeeded","failed","canceled","timed_out"],"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"jobs":{"type":"array","items":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"enum":["queued","running","cancel_requested","succeeded","failed","canceled","timed_out"],"type":"string"},"payment":{"type":"object","properties":{"rail":{"type":"string"},"status":{"enum":["paid","covered","refund_pending","refunded","refund_failed"],"type":"string"},"next_step":{"type":"string","description":"Present when refund_pending — the refund claim call to make"},"amount_cents":{"type":"integer"}},"description":"Billing state of the charge that funded this job"},"venue_id":{"type":"string","nullable":true},"charge_id":{"type":"string","format":"uuid"},"drop_time":{"type":"string","format":"date-time"},"party_size":{"type":"integer","nullable":true},"restaurant_name":{"type":"string","nullable":true},"reservation_date":{"type":"string","format":"date","nullable":true}}}},"count":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"jobs":[{"job_id":"0a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9","status":"queued","drop_time":"2026-07-15T13:00:00Z","restaurant_name":"4 Charles Prime Rib","reservation_date":"2026-08-14"}],"count":1}},"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_fk8pTluSVGlcvm5LegtNA","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":"Lists and filters reservation booking jobs submitted to the AgentRes/Resy system, returning their current status, restaurant details, and payment state.","exampleAgentPrompt":"Show me all my reservation jobs on AgentRes — especially any that are still queued or running — and let me know which ones succeeded and what the payment status is for each.","exampleUseCases":null,"resultDescription":"A JSON object containing a list of reservation job records and a total count. Each job record includes a UUID job ID, current status (queued, running, succeeded, failed, canceled, etc.), the target restaurant name, reservation date, party size, drop time, and detailed payment state (rail, payment status, amount in cents, and any pending refund claim instructions).","failureModes":["Invalid status enum value returns a validation error","Limit parameter out of range (below 1 or above 100) returns a validation error","Unauthenticated requests may return 401 or 402 requiring payment/auth","Empty result set returns jobs array with count 0 when no jobs match the filter","Network timeouts or upstream unavailability return 5xx errors"],"whenToPreferThis":"Use this endpoint when you need to poll or audit the state of previously submitted restaurant reservation jobs on AgentRes/Resy — for example, to check if a booking succeeded, confirm payment was processed, or identify jobs that need attention (failed, timed out, or pending refund). Prefer this over creating a new booking job when the goal is status monitoring or reporting rather than initiating a new reservation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:47:34.684Z","isFirstParty":false}