{"uid":"cap_iwFu2mtlCK92BfXzo7QcF","slug":"agentic-reservations-reservation-job-refund-ea89fd79","name":"Agentic Reservations — Reservation Job Refund","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/refund","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"refund":{"type":"object","properties":{"status":{"enum":["refunded","refund_failed","already_refunded","in_progress","none"],"type":"string"},"message":{"type":"string"},"tx_hash":{"type":"string"},"refund_id":{"type":"string","format":"uuid"}}},"success":{"type":"boolean"},"charge_id":{"type":"string","format":"uuid"}}}}}}},"responseSchema":{"type":"json","example":{"job_id":"0a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9","refund":{"status":"refunded","tx_hash":"0xabc123"},"success":true}},"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_x3ZevAPzlkiSXAwFD--ty","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":"Refunds a previously paid restaurant reservation booking job on the AgentRes/Resy platform, returning USDC to the agent's wallet","exampleAgentPrompt":"The Resy reservation booking job 0a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9 didn't work out — please refund the USDC payment for that job.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the job_id, a refund object with status ('refunded') and the on-chain transaction hash of the USDC refund, and a boolean success field confirming the refund was processed.","failureModes":["Job ID not found — 404 if the job_id does not exist or belongs to a different agent","Already refunded — error if refund was already issued for this job","Non-refundable job state — error if the job is in a state that does not qualify for a refund","Invalid job_id format — 400 if the UUID is malformed","Blockchain transaction failure — refund may fail if the on-chain USDC transfer cannot be completed"],"whenToPreferThis":"Use this endpoint when an AgentRes reservation booking job has failed, was cancelled, or otherwise did not result in a successful reservation and the agent needs to recover the USDC payment made for that job. Prefer this over manual wallet recovery when you have a valid job_id from a prior AgentRes booking attempt.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:41:22.090Z","isFirstParty":false}