Fetch a single video by its ID. The response includes the video’s metadata, a pre-signed URL, and branding details from the associated domain. If a call-to-action (CTA) is enabled on the video, additional CTA configuration fields are included.
Endpoint
Authentication
Pass your API key as a Bearer token in the Authorization header.
Your API key. Format: Bearer <api_key>.
Path parameters
The ID of the video to retrieve.
Response
ID of the domain this video was generated for.
Human-readable name of the video.
Pre-signed URL to stream or download the video file.
ISO 8601 timestamp when the video was created.
ISO 8601 timestamp when the video was last updated.
Your account’s organization or company name. Present when available.
Pre-signed URL for the domain’s logo image. Present when a logo is configured.
Button label for the CTA. Only present when cta_enabled is true.
Form field configuration for the CTA modal. Only present when cta_enabled is true and cta_type is form.
Title text for the CTA modal. Only present when cta_enabled is true.
Body text for the CTA modal. Only present when cta_enabled is true.
cta_use_organization_name
When true, the CTA displays your organization name instead of the domain’s application name. Only present when cta_enabled is true.
CTA type: form or external_link. Only present when cta_enabled is true.
Destination URL for external link CTAs (e.g. a calendar booking page). Only present when cta_enabled is true and cta_type is external_link.
When true, the CTA modal opens automatically after the video ends. Only present when cta_enabled is true.
The application name from the domain. Only present when cta_enabled is true.
Error responses
Status Description 400The provided id is not a valid number. 403The video exists but belongs to a different account. 404No video found with the given ID.
Examples
curl --request GET \
--url https://api.demomatic.tech/v1/videos/123 \
--header 'Authorization: Bearer YOUR_API_KEY'
Response (no CTA)
{
"data" : {
"id" : 123 ,
"domain_id" : 45 ,
"filename" : "Product Tour Q1 2024" ,
"url" : "https://signed-url.example.com/video.mp4" ,
"created_at" : "2024-01-15T10:00:00.000Z" ,
"updated_at" : "2024-01-15T10:05:00.000Z" ,
"organization_name" : "Acme Corp" ,
"logo_url" : "https://signed-url.example.com/logo.png"
}
}
Response (with CTA enabled)
{
"data" : {
"id" : 123 ,
"domain_id" : 45 ,
"filename" : "Product Tour Q1 2024" ,
"url" : "https://signed-url.example.com/video.mp4" ,
"created_at" : "2024-01-15T10:00:00.000Z" ,
"updated_at" : "2024-01-15T10:05:00.000Z" ,
"organization_name" : "Acme Corp" ,
"logo_url" : "https://signed-url.example.com/logo.png" ,
"cta_action_text" : "Book a demo" ,
"cta_fields" : [
{ "key" : "name" , "label" : "Name" , "type" : "text" , "required" : true },
{ "key" : "email" , "label" : "Work email" , "type" : "email" , "required" : true }
],
"cta_modal_title" : "Interested?" ,
"cta_modal_description" : "Fill in your details and we'll be in touch." ,
"cta_use_organization_name" : true ,
"cta_type" : "form" ,
"cta_external_link" : null ,
"cta_modal_auto_open" : false ,
"domain_application_name" : "Acme App"
}
}