{"uid":"cap_0SaFrH9Zh4uw4RODl21r9","slug":"stayapi-availability-check-258ce38a","name":"StayAPI Availability Check","description":"Accommodation search for AI agents. No auth, no subscriptions. Pay per request in USDC via x402.","url":"https://stay402.vercel.app/api/availability","method":"POST","headers":{},"bodySchema":{"type":"object","required":["id","checkin","checkout"],"properties":{"id":{"type":"string","description":"Hotel ID"},"checkin":{"type":"string","description":"Check-in date"},"checkout":{"type":"string","description":"Check-out date"}}},"responseSchema":{"type":"object","required":["success","data"],"properties":{"data":{"type":"object"},"success":{"type":"boolean"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XqnoL9TzBOYOD-BVNWHd2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks room availability for a specific hotel by ID given check-in and check-out dates, returning availability data for AI-driven accommodation booking flows.","exampleAgentPrompt":"Check if hotel ID 'htl_manhattan_89' is available from June 14 to June 18 — I want to know if there are rooms open for those four nights.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a boolean 'success' field and a 'data' object containing availability details for the queried hotel and date range.","failureModes":["Invalid or unknown hotel ID returns error or empty data","Malformed date strings cause request failure","Missing required fields (id, checkin, checkout) result in validation error","Payment failure via x402 protocol blocks the request","Dates in the past or illogical date ranges may return no availability","Service downtime on Vercel infrastructure causes 5xx errors"],"whenToPreferThis":"Use this endpoint when you have a specific hotel ID and need to check its availability for given dates without requiring API keys or subscriptions — ideal for lightweight, pay-per-use agent workflows using x402 USDC micropayments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:33:39.693Z","isFirstParty":false}