Skip to main content
Fetch all leads captured through the CTA form on a specific video. Leads are returned in reverse chronological order (most recent first).

Endpoint

GET /v1/videos/:id/leads

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 leads for.

Response

data
object
required
This endpoint only returns leads from CTA form submissions. Clicks on external link CTAs are tracked separately in the link_clicks field returned by Video Stats.

Error responses

StatusDescription
400The provided id is not a valid number.
404No video found with the given ID in your account.

Examples

curl --request GET \
  --url https://api.demomatic.tech/v1/videos/7/leads \
  --header 'Authorization: Bearer YOUR_API_KEY'

Response

200
{
  "data": {
    "leads": [
      {
        "id": 42,
        "video_id": 7,
        "response_data": {
          "name": "Alice Smith",
          "email": "alice@example.com"
        },
        "submitted_at": "2024-01-15T10:30:00.000Z",
        "internal_name": "Product Tour Q1 2024"
      }
    ]
  }
}