{"uid":"cap_N2irnaiYCKKLgURByQ3wI","slug":"agentic-reservations-get-reservation-job-status-0008201f","name":"Agentic Reservations — Get Reservation Job Status","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/%7Bjob_id%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"job_id":"0a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9","status":"succeeded","payment":{"rail":"x402_base_usdc","status":"paid","amount_cents":300},"drop_time":"2026-07-15T13:00:00Z","restaurant_name":"4 Charles Prime Rib","reservation_date":"2026-08-14"}},"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_WT9rewmATL3XM_WjeBkhd","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 the status and result of a previously submitted restaurant reservation booking job on Resy","exampleAgentPrompt":"Can you check whether that Resy reservation job I submitted earlier went through? The job ID is 0a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9 — I want to know if the booking at 4 Charles Prime Rib for August 14th succeeded and whether the payment was processed.","exampleUseCases":null,"resultDescription":"Returns a JSON object with the job_id, status (e.g. 'succeeded'), payment details (rail, status, amount in cents), the drop_time when the reservation was released, the restaurant name, and the reservation date.","failureModes":["Invalid or unknown job_id returns a 404 not found error","Job still pending returns a status other than 'succeeded' (e.g. 'pending' or 'failed')","Payment failure results in a failed job status with payment status not 'paid'","Malformed job_id format returns a 400 bad request","Network timeout if the polling request takes too long"],"whenToPreferThis":"Use this endpoint after submitting a reservation booking job to check its outcome. This is the polling/status-check step in the async reservation workflow — call it after receiving a job_id from the booking initiation endpoint. Prefer this over re-submitting a booking when you already have a job_id and just need to know if it succeeded.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:30:34.522Z","isFirstParty":false}