Skip to main content
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

GET /v1/videos/:id

Authentication

Pass your API key as a Bearer token in the Authorization header.
Authorization
string
required
Your API key. Format: Bearer <api_key>.

Path parameters

id
number
required
The ID of the video to retrieve.

Response

data
object
required

Error responses

StatusDescription
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)

200
{
  "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)

200
{
  "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"
  }
}