{"uid":"cap_K525IVGKDrDLsYhpGR37q","slug":"botpay-x402-video-access-api-fe73a8df","name":"BotPay x402 Video Access API","description":"Pay 0.01 USDC on Base mainnet through x402 to unlock a short-lived BotPay demo video stream.","url":"https://video.botpay.network/api/x402/video/watch","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"videoId":{"type":"string","description":"The video ID to unlock."}}},"responseSchema":{"type":"object","properties":{"type":{"type":"string","examples":["x402_video_access"]},"video":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"streamUrl":{"type":"string"},"contentType":{"type":"string"},"description":{"type":"string"},"thumbnailUrl":{"type":["string","null"]},"durationSeconds":{"type":"number"},"playbackPageUrl":{"type":"string"}}},"access":{"type":"object","properties":{"expiresAt":{"type":"string"},"expiresIn":{"type":"number"}}},"message":{"type":"string"},"payment":{"type":"object","properties":{"asset":{"type":"string"},"chain":{"type":"string"},"amount":{"type":"string"},"status":{"type":"string"},"network":{"type":"string"},"assetAddress":{"type":"string"},"displayAmount":{"type":"string"}}},"success":{"type":"boolean"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_c3DkEGuVJSApPh0FowT30","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Pay 0.01 USDC on Base mainnet via x402 to unlock a short-lived streaming URL for a BotPay demo video.","exampleAgentPrompt":"Unlock the BotPay demo video with ID 'demo-intro-001' by paying 0.01 USDC on Base — I want the streaming link and how long I have to watch it.","exampleUseCases":null,"resultDescription":"Returns a short-lived stream URL, playback page URL, video title, content type, duration in seconds, thumbnail URL, description, access expiry timestamp and countdown, payment confirmation details (asset, chain, amount, status, network, asset address, display amount), and a success flag.","failureModes":["Payment rejected or insufficient USDC balance — payment.status indicates failure","Invalid or unknown videoId — server returns error with success: false","Access token expired — expiresAt has passed, a new payment is required","Network error on Base mainnet — transaction cannot be confirmed","x402 protocol handshake failure — 402 response not resolved correctly"],"whenToPreferThis":"Use this endpoint when you need to unlock a specific BotPay-hosted video that sits behind an x402 micropayment gate on Base mainnet. It is the canonical endpoint for paying 0.01 USDC to receive a time-limited stream URL and is ideal when building agents that handle pay-per-view crypto-native video access flows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T05:26:43.801Z","isFirstParty":false}