{"uid":"cap_P-GUopO4URf05X1aqn6ba","slug":"stayapi-itinerary-search-415102c0","name":"StayAPI Itinerary Search","description":"Accommodation search for AI agents. No auth, no subscriptions. Pay per request in USDC via x402.","url":"https://stayapi-jet.vercel.app/api/itinerary","method":"POST","headers":{},"bodySchema":{"type":"object","required":["destination"],"properties":{"days":{"type":"integer","description":"Number of days"},"destination":{"type":"string","description":"Destination city"}}},"responseSchema":{"type":"object","required":["success","data"],"properties":{"data":{"type":"object"},"success":{"type":"boolean"}}},"example":{"request":{"days":3,"destination":"Paris"},"response":{"data":{"days":[],"summary":{"currency":"USD","grand_total":0,"total_transport":0,"total_activities":0,"total_accommodation":0},"destination":"Paris"},"meta":{"price":"$0.25","endpoint":"/api/itinerary","timestamp":"2026-06-18T06:48:00.713Z","data_source":"real"},"success":true}},"exampleRequest":{"days":3,"destination":"Paris"},"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0t9Veu9zaP6zVsKuwW8wx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches for accommodation options and generates a stay itinerary for a given destination city and number of days, billed per request in USDC via x402.","exampleAgentPrompt":"Search StayAPI for accommodation options in Kyoto for 5 days and show me what's available.","exampleUseCases":null,"resultDescription":"A JSON object with a success boolean and a data object containing accommodation options or an itinerary for the requested destination and duration.","failureModes":["Missing required 'destination' field returns a 400 validation error","Payment failure or insufficient USDC balance results in a 402 Payment Required response","Unknown or unsupported destination may return empty results or a 404","Invalid 'days' type (non-integer) triggers schema validation error","Network timeout or server error on Vercel returns a 500"],"whenToPreferThis":"Choose this endpoint when an AI agent needs frictionless, pay-per-use accommodation search without API keys or subscriptions — ideal for lightweight travel planning workflows where the agent handles crypto micropayments via x402 and needs quick lodging options for a specific city and trip length.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:55:39.556Z","isFirstParty":false}