{"service":"CinematicCard Agent API","description":"Programmatic access to create, pay for, and deliver cinematic video greeting cards. No browser required.","category":"digital-greeting-cards","version":"v1","updated_at":"2026-04-25T08:01:23.377Z","website":"https://cinematiccard.com","agents_page":"https://cinematiccard.com/agents","openapi":"https://cinematiccard.com/api/agent/v1/openapi.json","ucp":"https://cinematiccard.com/api/agent/v1/ucp","endpoints":[{"method":"GET","path":"https://cinematiccard.com/api/agent/v1/health","auth":"none","description":"Service health check"},{"method":"GET","path":"https://cinematiccard.com/api/agent/v1/manifest","auth":"none","description":"This discovery document"},{"method":"GET","path":"https://cinematiccard.com/api/agent/v1/themes","auth":"none","description":"All card themes with metadata"},{"method":"GET","path":"https://cinematiccard.com/api/agent/v1/pricing","auth":"none","description":"Full pricing in machine-readable form"},{"method":"POST","path":"https://cinematiccard.com/api/agent/v1/quote","auth":"none","description":"Get itemized quote (quoteId valid 30 min)"},{"method":"POST","path":"https://cinematiccard.com/api/agent/v1/checkout","auth":"optional","description":"Create, pay for, and deliver a card in one call"},{"method":"GET","path":"https://cinematiccard.com/api/agent/v1/order/:orderId","auth":"none","description":"Poll order status (idempotent)"},{"method":"GET","path":"https://cinematiccard.com/api/agent/v1/order/:orderId/views","auth":"none","description":"Card view count — has the recipient opened it?"},{"method":"POST","path":"https://cinematiccard.com/api/agent/v1/upload/photo","auth":"optional","description":"Upload photo via URL or multipart"},{"method":"GET","path":"https://cinematiccard.com/api/agent/v1/ucp","auth":"none","description":"Google Universal Commerce Protocol compatibility status"}],"payment_flows":[{"method":"hosted_checkout","description":"Returns a one-time Stripe Checkout URL. Agent hands URL to user. Webhook completes generation. Works with every agent on day one.","status":"live"},{"method":"payment_method","description":"Agent passes Stripe payment_method id (pm_xxx). Server confirms and generates card in-process. Returns cardUrl immediately.","status":"live"},{"method":"ucp","description":"Google Universal Commerce Protocol. Spec: https://developers.google.com/commerce/protocol. Status: stub ready, awaiting Google SDK GA.","status":"stub","spec_url":"https://developers.google.com/commerce/protocol"}],"auth":{"header":"X-Agent-Key","required":false,"effect":"Higher rate limits. Unauthed signature-tier orders flagged for human review.","request_key":"mailto:partnerships@cinematiccard.com"},"idempotency":{"header":"Idempotency-Key","body_field":"agent.orderReference","ttl_hours":24,"description":"Stable key for safe retries. Duplicate requests return original response unchanged."},"rate_limits":{"default":"60 req/min per IP","checkout_unauthed":"10 req/min per IP","checkout_authed":"60 req/min per IP"},"pricing_summary":{"currency":"USD","classic":"$3.99","classic_with_scheduled":"$4.99","classic_with_photos":"$6.99","classic_with_photos_scheduled":"$7.99","signature_with_cash_gift":"$9.99","signature_with_cash_gift_scheduled":"$10.99","add_custom_music":"+$3.00 any tier","note":"First card free available at cinematiccard.com consumer flow only, not via agent API."},"themes_count":53,"contact":"partnerships@cinematiccard.com"}