---
updatedAt: 2026-06-25T11:54:29.000Z
agentTools:
  projectIndex: https://developers.dailymotion.com/llms.txt
---

# Get a video

Return a single video by `video_id`. Supports sparse field selection
via `fields`. Requires `video.read`
[scope](https://developers.dailymotion.com/v2/reference/api-scopes).

<Callout icon="📘" theme="info">
  ### You are reading **API v2 documentation**

  Still using the Legacy API? Access the <Anchor target="_blank" href="https://developers.dailymotion.com/v0/docs/welcome">Legacy API documentation</Anchor>.
</Callout>

<br />

<br />

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Dailymotion API v2",
    "description": "The Dailymotion API v2 allows you \nto access and manage your Dailymotion content.\n",
    "version": "2.0.0"
  },
  "servers": [
    {
      "url": "https://api.dailymotion.com/v2",
      "description": "Production"
    }
  ],
  "paths": {
    "/videos/{id}": {
      "get": {
        "tags": [
          "Video"
        ],
        "summary": "Get a video",
        "description": "Return a single video by `video_id`. Supports sparse field selection\nvia `fields`. Requires `video.read`\n[scope](https://developers.dailymotion.com/v2/reference/api-scopes).",
        "operationId": "getVideo",
        "security": [
          {
            "Bearer": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Id"
            }
          },
          {
            "name": "fields",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Comma-separated field names to include. **Fields:** `ai_subtitles`, `available_formats`, `can_be_stitched`, `country`, `created_at`, `description`, `embedding`, `enable_ai_chapter_generation`, `enable_comments`, `engagement_message`, `first_frame`, `geo_restriction`, `has_paid_partnership`, `hashtags`, `is_ai_altered`, `is_exclusive_content`, `is_explicit`, `is_for_kids`, `is_published`, `language`, `preview`, `processing`, `profile`, `published_at`, `source`, `tags`, `thumbnail`, `title`, `updated_at`, `uploaded_at`, `video_id`, `video_url`, `visibility`. For embedded objects, use dot notation (e.g. `embedding.enable_embed`); **Embedded fields:** `embedding`, `first_frame`, `geo_restriction`, `preview`, `processing`, `profile`, `source`, `thumbnail`.",
              "title": "Fields"
            },
            "description": "Comma-separated field names to include. **Fields:** `ai_subtitles`, `available_formats`, `can_be_stitched`, `country`, `created_at`, `description`, `embedding`, `enable_ai_chapter_generation`, `enable_comments`, `engagement_message`, `first_frame`, `geo_restriction`, `has_paid_partnership`, `hashtags`, `is_ai_altered`, `is_exclusive_content`, `is_explicit`, `is_for_kids`, `is_published`, `language`, `preview`, `processing`, `profile`, `published_at`, `source`, `tags`, `thumbnail`, `title`, `updated_at`, `uploaded_at`, `video_id`, `video_url`, `visibility`. For embedded objects, use dot notation (e.g. `embedding.enable_embed`); **Embedded fields:** `embedding`, `first_frame`, `geo_restriction`, `preview`, `processing`, `profile`, `source`, `thumbnail`."
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VideoGetResponse"
                }
              }
            }
          },
          "401": {
            "description": "**Authentication failed.** No ``Authorization: Bearer`` header, malformed JWT, expired passport, or invalid signature. Identity is not established—unlike **403**, the caller is not treated as an authenticated subject. Typical ``error.code`` values: ``INVALID_AUTHORIZATION``, ``AUTHORIZATION_EXPIRED``.",
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "AUTHORIZATION_EXPIRED",
                    "message": "Authorization expired.",
                    "correlation_id": "550e8400-e29b-41d4-a716-446655440000",
                    "details": {
                      "param": "authorization"
                    },
                    "documentation_url": "https://developers.dailymotion.com/reference/api-errors"
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/DomainErrorEnvelope"
                }
              }
            }
          },
          "403": {
            "description": "**Authorization failed.** The bearer token was accepted, but the caller lacks required OAuth scopes or permissions, or an upstream service denied access to the resource. Typical ``error.code`` values: ``MISSING_PERMISSIONS``, ``UPSTREAM_ACCESS_DENIED``.",
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "MISSING_PERMISSIONS",
                    "message": "Missing required permissions: playlist:write. Required: playlist:read, playlist:write.",
                    "correlation_id": "550e8400-e29b-41d4-a716-446655440000",
                    "details": {
                      "required_permissions": [
                        "playlist:read",
                        "playlist:write"
                      ],
                      "missing_permissions": [
                        "playlist:write"
                      ]
                    },
                    "documentation_url": "https://developers.dailymotion.com/reference/api-errors"
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/DomainErrorEnvelope"
                }
              }
            }
          },
          "404": {
            "description": "**Resource not found.** The path id does not exist, a parent resource in a nested URL is missing, or the object is not visible. Typical ``error.code``: ``RESOURCE_NOT_FOUND``.",
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RESOURCE_NOT_FOUND",
                    "message": "Video with ID 'x1' not found.",
                    "correlation_id": "550e8400-e29b-41d4-a716-446655440000",
                    "details": {
                      "object_id": "x1",
                      "reason": "object_not_found",
                      "object_type": "Video",
                      "param": "id"
                    },
                    "documentation_url": "https://developers.dailymotion.com/reference/api-errors"
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/DomainErrorEnvelope"
                }
              }
            }
          },
          "422": {
            "description": "**Unprocessable entity (422).** Invalid **path, query, and body parameters** (FastAPI/Pydantic). **Domain validation** (``DomainValidationError`` and subclasses). **Missing context** (e.g. ``MISSING_PARENT_ID``, ``MISSING_REQUIRED_VALUE``). All 422 responses share the same {\"error\": {\"code\", \"message\", \"correlation_id\", \"details\", \"documentation_url\"}} envelope; code and details vary by error origin.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DomainErrorEnvelope"
                }
              }
            }
          },
          "429": {
            "description": "**Rate limiting (reserved).** This BFF process does not currently return 429. Clients that reach the API through a gateway or CDN should still be prepared for 429 and ``Retry-After`` from those layers.",
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "TOO_MANY_REQUESTS",
                    "message": "Too many requests. Retry after the indicated delay.",
                    "correlation_id": "550e8400-e29b-41d4-a716-446655440000",
                    "details": {
                      "retry_after_seconds": 60
                    },
                    "documentation_url": "https://developers.dailymotion.com/reference/api-errors"
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/DomainErrorEnvelope"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AvailableFormatGetResponse": {
        "properties": {
          "format_id": {
            "type": "string",
            "title": "Format Id",
            "description": "Unique identifier for this format. (default)",
            "example": "vf_720p_h264"
          },
          "type": {
            "$ref": "#/components/schemas/FormatType",
            "description": "Nature of the stream (video, audio, or muxed). (default)",
            "example": "video"
          },
          "label": {
            "type": "string",
            "title": "Label",
            "description": "Human-readable label. (default)",
            "example": "720p"
          },
          "quality": {
            "type": "string",
            "title": "Quality",
            "description": "Quality descriptor. (default)",
            "example": "HD"
          },
          "codecs": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Codecs",
            "description": "Codec identifiers for this format. (default)",
            "example": [
              "h264"
            ]
          },
          "sample_rate": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sample Rate",
            "description": "Audio sample rate in Hz; null for video-only formats.\n\nNot populated by upstream yet. (default)"
          },
          "frame_rate": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Frame Rate",
            "description": "Video frame rate in fps; null for audio-only formats.\n\nNot populated by upstream yet. (default)"
          },
          "bitrate": {
            "type": "integer",
            "title": "Bitrate",
            "description": "Bitrate in bits per second. (default)",
            "example": 2500000
          },
          "language": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Language",
            "description": "Language tag when applicable. (default)",
            "example": "en"
          },
          "sub_type": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FormatSubType"
              },
              {
                "type": "null"
              }
            ],
            "description": "Audio variant type; null for video or undifferentiated formats. (default)",
            "example": "original"
          }
        },
        "type": "object",
        "title": "Available Format Get Response",
        "example": {
          "format_id": "vf_720p_h264",
          "type": "video",
          "label": "720p",
          "quality": "HD",
          "codecs": [
            "h264"
          ],
          "bitrate": 2500000,
          "language": "en",
          "sub_type": "original"
        }
      },
      "DomainErrorEnvelope": {
        "properties": {
          "error": {
            "$ref": "#/components/schemas/DomainErrorPayload"
          }
        },
        "type": "object",
        "required": [
          "error"
        ],
        "title": "DomainErrorEnvelope",
        "description": "Standard error body: ``{ \"error\": { ... } }``.\n\nPer-HTTP-status examples (401 vs 403 vs 404, etc.) are attached on each\nresponse in :func:`bff_api.entrypoints.api.openapi.responses.\nstandard_domain_error_responses`, not on this schema alone."
      },
      "DomainErrorPayload": {
        "properties": {
          "code": {
            "type": "string",
            "title": "Code",
            "description": "Stable machine-readable error code (e.g. RESOURCE_NOT_FOUND, MISSING_PERMISSIONS)."
          },
          "message": {
            "type": "string",
            "title": "Message",
            "description": "Human-readable summary."
          },
          "correlation_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Correlation Id",
            "description": "Request correlation id for support (may be null)."
          },
          "details": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Details",
            "description": "Structured context; shape depends on *code*."
          },
          "documentation_url": {
            "type": "string",
            "title": "Documentation Url",
            "description": "Link to the public API error reference."
          }
        },
        "type": "object",
        "required": [
          "code",
          "message",
          "documentation_url"
        ],
        "title": "DomainErrorPayload",
        "description": "Fields inside the ``error`` object for non-2xx domain errors."
      },
      "FirstFrameGetResponse": {
        "properties": {
          "h1080_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "H1080 Url",
            "description": "1080px-height first-frame URL (default sub-field for ``first_frame``). (default)",
            "example": "https://s1.dmcdn.net/v/SomeVideo/x1080-abc.jpg"
          },
          "h720_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "H720 Url",
            "description": "720px-height first-frame URL.",
            "example": "https://s1.dmcdn.net/v/SomeVideo/x720-abc.jpg"
          },
          "h480_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "H480 Url",
            "description": "480px-height first-frame URL.",
            "example": "https://s1.dmcdn.net/v/SomeVideo/x480-abc.jpg"
          },
          "h360_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "H360 Url",
            "description": "360px-height first-frame URL.",
            "example": "https://s1.dmcdn.net/v/SomeVideo/x360-abc.jpg"
          },
          "h240_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "H240 Url",
            "description": "240px-height first-frame URL.",
            "example": "https://s1.dmcdn.net/v/SomeVideo/x240-abc.jpg"
          },
          "h180_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "H180 Url",
            "description": "180px-height first-frame URL.",
            "example": "https://s1.dmcdn.net/v/SomeVideo/x180-abc.jpg"
          },
          "h120_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "H120 Url",
            "description": "120px-height first-frame URL.",
            "example": "https://s1.dmcdn.net/v/SomeVideo/x120-abc.jpg"
          },
          "h60_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "H60 Url",
            "description": "60px-height first-frame URL.",
            "example": "https://s1.dmcdn.net/v/SomeVideo/x60-abc.jpg"
          }
        },
        "type": "object",
        "title": "First Frame Get Response",
        "example": {
          "h1080_url": "https://s1.dmcdn.net/v/SomeVideo/x1080-abc.jpg",
          "h720_url": "https://s1.dmcdn.net/v/SomeVideo/x720-abc.jpg",
          "h480_url": "https://s1.dmcdn.net/v/SomeVideo/x480-abc.jpg",
          "h360_url": "https://s1.dmcdn.net/v/SomeVideo/x360-abc.jpg",
          "h240_url": "https://s1.dmcdn.net/v/SomeVideo/x240-abc.jpg",
          "h180_url": "https://s1.dmcdn.net/v/SomeVideo/x180-abc.jpg",
          "h120_url": "https://s1.dmcdn.net/v/SomeVideo/x120-abc.jpg",
          "h60_url": "https://s1.dmcdn.net/v/SomeVideo/x60-abc.jpg"
        }
      },
      "FormatSubType": {
        "type": "string",
        "enum": [
          "original",
          "dubbed",
          "dubbed_ai",
          "audiodescription"
        ],
        "title": "FormatSubType",
        "description": "Audio variant type for a delivery format."
      },
      "FormatType": {
        "type": "string",
        "enum": [
          "video",
          "audio",
          "muxed"
        ],
        "title": "FormatType",
        "description": "Nature of an encoded delivery format."
      },
      "GeoRestrictionGetResponse": {
        "properties": {
          "mode": {
            "$ref": "#/components/schemas/GeoRestrictionMode",
            "description": "Which kind of list `countries` is: `allow` for an allowlist (only\nthe listed countries may watch), `deny` for a denylist (every country\nexcept the listed ones may watch). `countries` keeps that meaning even\nwhen it is empty:\n\n| mode | countries | Meaning |\n|---|---|---|\n| `deny` | `[]` | No restriction: every country may watch |\n| `deny` | `[\"FR\", \"US\"]` | Every country except FR and US may watch |\n| `allow` | `[\"FR\", \"US\"]` | Only FR and US may watch |\n| `allow` | `[]` | No country may watch |\n\nSo \"no restriction\" is `deny` with no country, not `allow`: `allow`\nwith an empty list allows no country at all. (default)",
            "example": "allow"
          },
          "countries": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Countries",
            "description": "Uppercase ISO 3166-1 alpha-2 country codes, allowed or denied\naccording to ``mode``.\n\nRequired when a ``geo_restriction`` object is provided. An empty list\nkeeps its meaning under ``mode``: with ``deny`` nothing is restricted,\nwith ``allow`` no country may watch. That last state can be read but not\nwritten yet: a write of ``allow`` with no country is rejected, so use\n``deny`` with no country to remove every restriction. (default)",
            "example": [
              "US",
              "FR",
              "DE"
            ]
          }
        },
        "type": "object",
        "title": "Geo Restriction Get Response",
        "example": {
          "mode": "allow",
          "countries": [
            "US",
            "FR",
            "DE"
          ]
        }
      },
      "GeoRestrictionMode": {
        "type": "string",
        "enum": [
          "allow",
          "deny"
        ],
        "title": "GeoRestrictionMode",
        "description": "Which kind of list a geo restriction's countries are.\n\n``allow``: only the listed countries may watch (none when empty).\n``deny``: every country except the listed ones may watch (all when empty)."
      },
      "PreviewGetResponse": {
        "properties": {
          "p480_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "P480 Url",
            "description": "480p preview clip URL (default sub-field for ``preview``). (default)",
            "example": "https://vod3.dmcdn.net/p/SomeVideo/x480-xyz.mp4"
          },
          "p360_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "P360 Url",
            "description": "360p preview clip URL.",
            "example": "https://vod3.dmcdn.net/p/SomeVideo/x360-xyz.mp4"
          },
          "p240_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "P240 Url",
            "description": "240p preview clip URL.",
            "example": "https://vod3.dmcdn.net/p/SomeVideo/x240-xyz.mp4"
          }
        },
        "type": "object",
        "title": "Preview Get Response",
        "example": {
          "p480_url": "https://vod3.dmcdn.net/p/SomeVideo/x480-xyz.mp4",
          "p360_url": "https://vod3.dmcdn.net/p/SomeVideo/x360-xyz.mp4",
          "p240_url": "https://vod3.dmcdn.net/p/SomeVideo/x240-xyz.mp4"
        }
      },
      "ProcessingGetResponse": {
        "properties": {
          "encoding_status": {
            "$ref": "#/components/schemas/VideoEncodingStatus",
            "description": "Current step in the encoding pipeline. (default)",
            "example": "encoded"
          },
          "encoding_progress": {
            "type": "integer",
            "title": "Encoding Progress",
            "description": "Encoding completion percentage (0–100). (default)",
            "example": 100
          },
          "publishing_progress": {
            "type": "integer",
            "title": "Publishing Progress",
            "description": "Mandatory format publishing completion percentage (0–100). (default)",
            "example": 100
          }
        },
        "type": "object",
        "title": "Processing Get Response",
        "example": {
          "encoding_status": "encoded",
          "encoding_progress": 100,
          "publishing_progress": 100
        }
      },
      "ProfileContentDefaultsGetResponse": {
        "properties": {
          "language": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Language",
            "description": "Default ISO 639-1 language code for new uploads. (default)",
            "example": "en"
          },
          "visibility": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ProfileContentDefaultsVisibility"
              },
              {
                "type": "null"
              }
            ],
            "description": "Default visibility for new videos (`public` or `private`). (default)",
            "example": "public"
          },
          "is_for_kids": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is For Kids",
            "description": "Default “made for kids” flag for new videos. (default)",
            "example": false
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title",
            "description": "Default title template for new uploads. (default)",
            "example": "Untitled broadcast"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description",
            "description": "Default description for new uploads. (default)",
            "example": "Thanks for watching!"
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Tags",
            "description": "Default tags applied to new videos. (default)",
            "example": [
              "news",
              "weekly"
            ]
          },
          "category": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/VideoCategory"
              },
              {
                "type": "null"
              }
            ],
            "description": "Default content category for new videos. (default)",
            "example": "news"
          },
          "ai_subtitles": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Ai Subtitles",
            "description": "Languages for AI-generated subtitles on new videos. (default)",
            "example": [
              "en",
              "fr"
            ]
          },
          "enable_comments": {
            "type": "boolean",
            "title": "Enable Comments",
            "description": "Whether comments are enabled by default on new videos. (default)",
            "example": true
          },
          "enable_ai_chapter_generation": {
            "type": "boolean",
            "title": "Enable Ai Chapter Generation",
            "description": "Whether AI chapter generation is enabled by default. (default)",
            "example": true
          },
          "geo_restriction": {
            "$ref": "#/components/schemas/GeoRestrictionGetResponse",
            "description": "Default geo restriction for new videos. (default)",
            "example": "{\"mode\": \"allow\", \"countries\": [\"US\", \"FR\"]}"
          }
        },
        "type": "object",
        "title": "Profile Content Defaults Get Response",
        "example": {
          "language": "en",
          "visibility": "public",
          "is_for_kids": false,
          "title": "Untitled broadcast",
          "description": "Thanks for watching!",
          "tags": [
            "news",
            "weekly"
          ],
          "category": "news",
          "ai_subtitles": [
            "en",
            "fr"
          ],
          "enable_comments": true,
          "enable_ai_chapter_generation": true,
          "geo_restriction": {
            "mode": "allow",
            "countries": [
              "US",
              "FR",
              "DE"
            ]
          }
        }
      },
      "ProfileContentDefaultsVisibility": {
        "type": "string",
        "enum": [
          "public",
          "private"
        ],
        "title": "ProfileContentDefaultsVisibility",
        "description": "Profile content default visibility."
      },
      "ProfileGetResponse": {
        "properties": {
          "profile_id": {
            "type": "string",
            "title": "Profile Id",
            "description": "Unique identifier of the profile. (default)",
            "example": "x1y2z3"
          },
          "name": {
            "type": "string",
            "title": "Name",
            "description": "Unique profile name used in URLs (e.g., @profilename). (default)",
            "example": "officialdailymotion"
          },
          "display_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Display Name",
            "description": "Display name shown on the profile page. Maximum 50 characters.",
            "example": "Dailymotion Official"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description",
            "description": "Profile description. Maximum 2000 characters. HTML allowed.",
            "example": "Welcome to our official channel — weekly uploads."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At",
            "description": "ISO 8601 timestamp when the profile was created. (default)",
            "example": "2020-01-01T00:00:00Z"
          },
          "can_change_name": {
            "type": "boolean",
            "title": "Can Change Name",
            "description": "Whether the profile's name can currently be changed.",
            "example": true
          },
          "social_links": {
            "$ref": "#/components/schemas/ProfileSocialLinksGetResponse",
            "description": "Social links associated with the profile.",
            "example": "{\"twitter_url\": \"https://x.com/mychannel\"}"
          },
          "content_defaults": {
            "$ref": "#/components/schemas/ProfileContentDefaultsGetResponse",
            "description": "Content default settings for the profile.",
            "example": "{\"language\": \"en\", \"visibility\": \"public\"}"
          },
          "webhook": {
            "$ref": "#/components/schemas/ProfileWebhookGetResponse",
            "description": "Webhook configuration associated with the profile.",
            "example": "{\"callback_url\": \"https://api.example.com/hooks/dm\",\n\"events\": [\"video.created\"]}"
          }
        },
        "type": "object",
        "title": "Profile Get Response",
        "example": {
          "profile_id": "x1y2z3",
          "name": "officialdailymotion",
          "display_name": "Dailymotion Official",
          "description": "Welcome to our official channel — weekly uploads.",
          "created_at": "2020-01-01T00:00:00Z",
          "can_change_name": true,
          "social_links": {
            "twitter_url": "https://x.com/mychannel",
            "instagram_url": "https://instagram.com/mychannel",
            "facebook_url": "https://facebook.com/mychannel",
            "website_url": "https://www.example.com"
          },
          "content_defaults": {
            "language": "en",
            "visibility": "public",
            "is_for_kids": false,
            "title": "Untitled broadcast",
            "description": "Thanks for watching!",
            "tags": [
              "news",
              "weekly"
            ],
            "category": "news",
            "ai_subtitles": [
              "en",
              "fr"
            ],
            "enable_comments": true,
            "enable_ai_chapter_generation": true,
            "geo_restriction": {
              "mode": "allow",
              "countries": [
                "US",
                "FR",
                "DE"
              ]
            }
          },
          "webhook": {
            "callback_url": "https://api.example.com/v1/webhooks/dailymotion",
            "events": [
              "video.created",
              "video.published"
            ]
          }
        }
      },
      "ProfileSocialLinksGetResponse": {
        "properties": {
          "twitter_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Twitter Url",
            "description": "URL of the channel profile on X (Twitter).",
            "example": "https://x.com/mychannel"
          },
          "instagram_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Instagram Url",
            "description": "URL of the Instagram profile.",
            "example": "https://instagram.com/mychannel"
          },
          "facebook_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Facebook Url",
            "description": "URL of the Facebook page.",
            "example": "https://facebook.com/mychannel"
          },
          "website_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Website Url",
            "description": "Official website URL for the channel. (default)",
            "example": "https://www.example.com"
          }
        },
        "type": "object",
        "title": "Profile Social Links Get Response",
        "example": {
          "twitter_url": "https://x.com/mychannel",
          "instagram_url": "https://instagram.com/mychannel",
          "facebook_url": "https://facebook.com/mychannel",
          "website_url": "https://www.example.com"
        }
      },
      "ProfileWebhookEvent": {
        "type": "string",
        "enum": [
          "video.created",
          "video.deleted",
          "video.published",
          "video.complete",
          "video.format.ready",
          "video.format.processing",
          "video.format.error",
          "video.format.deleted"
        ],
        "title": "ProfileWebhookEvent",
        "description": "Valid profile webhook event values."
      },
      "ProfileWebhookGetResponse": {
        "properties": {
          "callback_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Callback Url",
            "description": "HTTPS endpoint that receives webhook POST payloads. (default)",
            "example": "https://api.example.com/v1/webhooks/dailymotion"
          },
          "events": {
            "items": {
              "$ref": "#/components/schemas/ProfileWebhookEvent"
            },
            "type": "array",
            "title": "Events",
            "description": "Event types to deliver to `callback_url`. (default)",
            "example": [
              "video.created",
              "video.published"
            ]
          }
        },
        "type": "object",
        "title": "Profile Webhook Get Response",
        "example": {
          "callback_url": "https://api.example.com/v1/webhooks/dailymotion",
          "events": [
            "video.created",
            "video.published"
          ]
        }
      },
      "SourceGetResponse": {
        "properties": {
          "duration": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Duration",
            "description": "Duration of the source media in whole seconds (strictly positive).",
            "example": 125
          },
          "width": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Width",
            "description": "Width of the source media in pixels (strictly positive). (default)",
            "example": 1920
          },
          "height": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Height",
            "description": "Height of the source media in pixels (strictly positive). (default)",
            "example": 1080
          },
          "aspect_ratio": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Aspect Ratio",
            "description": "Width divided by height of the source frame (strictly positive).",
            "example": 1.777777
          },
          "checksum": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Checksum",
            "description": "SHA-256 checksum of the source media file (hex). (default)",
            "example": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
          }
        },
        "type": "object",
        "title": "Source Get Response",
        "example": {
          "duration": 125,
          "width": 1920,
          "height": 1080,
          "aspect_ratio": 1.777777,
          "checksum": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
        }
      },
      "VideoCategory": {
        "type": "string",
        "enum": [
          "animals",
          "auto",
          "creation",
          "fun",
          "kids",
          "lifestyle",
          "music",
          "news",
          "people",
          "school",
          "sport",
          "tech",
          "travel",
          "tv",
          "videogames",
          "webcam"
        ],
        "title": "VideoCategory",
        "description": "Content category shared by videos and livestreams."
      },
      "VideoEncodingStatus": {
        "type": "string",
        "enum": [
          "waiting_for_upload",
          "uploaded",
          "encoding",
          "encoded",
          "error"
        ],
        "title": "VideoEncodingStatus",
        "description": "Video encoding pipeline status (v2);\nsourced from v1 ``status`` + progress fields."
      },
      "VideoGetResponse": {
        "properties": {
          "video_id": {
            "type": "string",
            "title": "Video Id",
            "description": "Public video identifier. (default)",
            "example": "x8abc123"
          },
          "title": {
            "type": "string",
            "title": "Title",
            "description": "Video title shown in the player and catalog. (default)",
            "example": "Product launch keynote 2024"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description",
            "description": "Short or long description; HTML allowed where configured.",
            "example": "Highlights from our annual developer conference."
          },
          "visibility": {
            "$ref": "#/components/schemas/Visibility",
            "description": "Who can watch the video (`public`, `private`, or `password`).",
            "example": "public"
          },
          "is_for_kids": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is For Kids",
            "description": "Whether the video is made for kids (COPPA). Required on create.",
            "example": false
          },
          "is_explicit": {
            "type": "boolean",
            "title": "Is Explicit",
            "description": "Whether the video is explicit.\n**Warning** This flag cannot be removed once set.",
            "example": false
          },
          "can_be_stitched": {
            "type": "boolean",
            "title": "Can Be Stitched",
            "description": "Whether the video may be used as a source for content stitching.\n\nStitching requires a public video: setting it on a private or\npassword-protected video leaves it disabled.",
            "example": true
          },
          "enable_comments": {
            "type": "boolean",
            "title": "Enable Comments",
            "description": "Whether comments are enabled on this video.\n\nComments cannot be enabled on a video made for kids: the request is\nrefused upstream with **403**.",
            "example": true
          },
          "is_exclusive_content": {
            "type": "boolean",
            "title": "Is Exclusive Content",
            "description": "Whether the video is exclusive to Dailymotion.",
            "example": false
          },
          "has_paid_partnership": {
            "type": "boolean",
            "title": "Has Paid Partnership",
            "description": "Whether the video discloses a paid partnership.",
            "example": false
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At",
            "description": "Creation time in ISO 8601 format. (default)",
            "example": "2024-06-01T14:30:00Z"
          },
          "profile": {
            "$ref": "#/components/schemas/ProfileGetResponse",
            "description": "Profile associated with the video.",
            "example": "{\"profile_id\": \"x1y2z3\", \"name\": \"mychannel\"}"
          },
          "video_url": {
            "type": "string",
            "title": "Video Url",
            "description": "URL of the video.",
            "example": "https://www.dailymotion.com/video/x26m1j4"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "title": "Updated At",
            "description": "ISO 8601 timestamp when the video was last updated.",
            "example": "2024-06-01T14:30:00Z"
          },
          "uploaded_at": {
            "type": "string",
            "format": "date-time",
            "title": "Uploaded At",
            "description": "ISO 8601 timestamp when the video was uploaded.",
            "example": "2024-06-01T14:30:00Z"
          },
          "published_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Published At",
            "description": "ISO 8601 timestamp when the video was published.",
            "example": "2024-06-01T14:30:00Z"
          },
          "language": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Language",
            "description": "ISO 639-1 language code (e.g. en, fr).",
            "example": "en"
          },
          "country": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Country",
            "description": "ISO 3166-1 alpha-2 country code (e.g. US, FR).",
            "example": "US"
          },
          "engagement_message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Engagement Message",
            "description": "Engagement message associated with the video.",
            "example": "Join the conversation and leave a comment!"
          },
          "hashtags": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Hashtags",
            "description": "Hashtags associated with the video.",
            "example": [
              "#productlaunch",
              "#keynote"
            ]
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Tags",
            "description": "Tags associated with the video.",
            "example": [
              "productlaunch",
              "keynote"
            ]
          },
          "is_published": {
            "type": "boolean",
            "title": "Is Published",
            "description": "Whether the video is published (may still be waiting for encoding,\nsee the processing.encoding_status field for more information).",
            "example": true
          },
          "processing": {
            "$ref": "#/components/schemas/ProcessingGetResponse",
            "description": "Encoding and publishing pipeline state (read-only).",
            "example": "{\"encoding_status\": \"encoded\", \"encoding_progress\": 100,\n\"publishing_progress\": 100}"
          },
          "available_formats": {
            "items": {
              "$ref": "#/components/schemas/AvailableFormatGetResponse"
            },
            "type": "array",
            "title": "Available Formats",
            "description": "Encoded formats available for this video (read-only).\n\nUse ``?fields=available_formats`` to include the full list.",
            "example": [
              {
                "bitrate": 2500000,
                "codecs": [
                  "h264"
                ],
                "format_id": "vf_720p_h264",
                "label": "720p",
                "quality": "HD",
                "type": "video"
              }
            ]
          },
          "is_ai_altered": {
            "type": "boolean",
            "title": "Is Ai Altered",
            "description": "Whether the video content was altered with AI.",
            "example": true
          },
          "ai_subtitles": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Ai Subtitles",
            "description": "Languages available for AI-generated subtitles.",
            "example": [
              "en",
              "fr"
            ]
          },
          "enable_ai_chapter_generation": {
            "type": "boolean",
            "title": "Enable Ai Chapter Generation",
            "description": "Whether AI chapter generation is enabled.",
            "example": true
          },
          "embedding": {
            "$ref": "#/components/schemas/VideoNestedEmbeddingGetResponse",
            "description": "Embed settings for this video.",
            "example": "{\"enable_embed\": true}"
          },
          "geo_restriction": {
            "$ref": "#/components/schemas/GeoRestrictionGetResponse",
            "description": "Embedded object for video geo restriction fields.",
            "example": "{\"mode\": \"allow\", \"countries\": [\"US\", \"FR\"]}"
          },
          "source": {
            "$ref": "#/components/schemas/SourceGetResponse",
            "description": "Source media metadata and optional ingest URL for create/replace.",
            "example": "{\"duration\": 120, \"width\": 1280, \"height\": 720, \"aspect_ratio\": 1.777777,\n\"checksum\":\n\"0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef\"}"
          },
          "thumbnail": {
            "$ref": "#/components/schemas/VideoNestedThumbnailGetResponse",
            "description": "Thumbnail stills at multiple heights (h-prefixed resolution URLs).\nRead-only. Sparse default when ``?fields=thumbnail``: ``h1080_url`` only.",
            "example": "{\"h1080_url\": \"https://s1.dmcdn.net/v/SomeVideo/x1080-YZy.jpg\"}"
          },
          "first_frame": {
            "$ref": "#/components/schemas/FirstFrameGetResponse",
            "description": "First-frame stills at multiple heights (h-prefixed resolution URLs).\nRead-only. Sparse default when ``?fields=first_frame``: ``h1080_url`` only.",
            "example": "{\"h1080_url\": \"https://s1.dmcdn.net/v/SomeVideo/x1080-abc.jpg\"}"
          },
          "preview": {
            "$ref": "#/components/schemas/PreviewGetResponse",
            "description": "Short preview clips by progressive quality (p-prefixed URLs).\nRead-only. Sparse default when ``?fields=preview``: ``p480_url`` only.",
            "example": "{\"p480_url\": \"https://vod3.dmcdn.net/p/SomeVideo/x480-xyz.mp4\"}"
          }
        },
        "type": "object",
        "title": "Video Get Response",
        "example": {
          "video_id": "x8abc123",
          "title": "Product launch keynote 2024",
          "description": "Highlights from our annual developer conference.",
          "visibility": "public",
          "is_for_kids": false,
          "is_explicit": false,
          "can_be_stitched": true,
          "enable_comments": true,
          "is_exclusive_content": false,
          "has_paid_partnership": false,
          "created_at": "2024-06-01T14:30:00Z",
          "profile": {
            "profile_id": "x1y2z3",
            "name": "officialdailymotion",
            "display_name": "Dailymotion Official",
            "description": "Welcome to our official channel — weekly uploads.",
            "created_at": "2020-01-01T00:00:00Z",
            "can_change_name": true,
            "social_links": {
              "twitter_url": "https://x.com/mychannel",
              "instagram_url": "https://instagram.com/mychannel",
              "facebook_url": "https://facebook.com/mychannel",
              "website_url": "https://www.example.com"
            },
            "content_defaults": {
              "language": "en",
              "visibility": "public",
              "is_for_kids": false,
              "title": "Untitled broadcast",
              "description": "Thanks for watching!",
              "tags": [
                "news",
                "weekly"
              ],
              "category": "news",
              "ai_subtitles": [
                "en",
                "fr"
              ],
              "enable_comments": true,
              "enable_ai_chapter_generation": true,
              "geo_restriction": {
                "mode": "allow",
                "countries": [
                  "US",
                  "FR",
                  "DE"
                ]
              }
            },
            "webhook": {
              "callback_url": "https://api.example.com/v1/webhooks/dailymotion",
              "events": [
                "video.created",
                "video.published"
              ]
            }
          },
          "video_url": "https://www.dailymotion.com/video/x26m1j4",
          "updated_at": "2024-06-01T14:30:00Z",
          "uploaded_at": "2024-06-01T14:30:00Z",
          "published_at": "2024-06-01T14:30:00Z",
          "language": "en",
          "country": "US",
          "engagement_message": "Join the conversation and leave a comment!",
          "hashtags": [
            "#productlaunch",
            "#keynote"
          ],
          "tags": [
            "productlaunch",
            "keynote"
          ],
          "is_published": true,
          "processing": {
            "encoding_status": "encoded",
            "encoding_progress": 100,
            "publishing_progress": 100
          },
          "available_formats": [
            {
              "format_id": "vf_720p_h264",
              "type": "video",
              "label": "720p",
              "quality": "HD",
              "codecs": [
                "h264"
              ],
              "sample_rate": null,
              "frame_rate": null,
              "bitrate": 2500000,
              "language": null,
              "sub_type": null
            }
          ],
          "is_ai_altered": true,
          "ai_subtitles": [
            "en",
            "fr"
          ],
          "enable_ai_chapter_generation": true,
          "embedding": {
            "enable_embed": true
          },
          "geo_restriction": {
            "mode": "allow",
            "countries": [
              "US",
              "FR",
              "DE"
            ]
          },
          "source": {
            "duration": 125,
            "width": 1920,
            "height": 1080,
            "aspect_ratio": 1.777777,
            "checksum": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
          },
          "thumbnail": {
            "h1080_url": "https://s1.dmcdn.net/v/SomeVideo/x1080-YZy.jpg",
            "h720_url": "https://s1.dmcdn.net/v/SomeVideo/x720-YZy.jpg",
            "h480_url": "https://s1.dmcdn.net/v/SomeVideo/x480-YZy.jpg",
            "h360_url": "https://s1.dmcdn.net/v/SomeVideo/x360-YZy.jpg",
            "h240_url": "https://s1.dmcdn.net/v/SomeVideo/x240-YZy.jpg",
            "h180_url": "https://s1.dmcdn.net/v/SomeVideo/x180-YZy.jpg",
            "h120_url": "https://s1.dmcdn.net/v/SomeVideo/x120-YZy.jpg",
            "h62_url": "https://s1.dmcdn.net/v/SomeVideo/x62-YZy.jpg",
            "h60_url": "https://s1.dmcdn.net/v/SomeVideo/x60-YZy.jpg"
          },
          "first_frame": {
            "h1080_url": "https://s1.dmcdn.net/v/SomeVideo/x1080-abc.jpg",
            "h720_url": "https://s1.dmcdn.net/v/SomeVideo/x720-abc.jpg",
            "h480_url": "https://s1.dmcdn.net/v/SomeVideo/x480-abc.jpg",
            "h360_url": "https://s1.dmcdn.net/v/SomeVideo/x360-abc.jpg",
            "h240_url": "https://s1.dmcdn.net/v/SomeVideo/x240-abc.jpg",
            "h180_url": "https://s1.dmcdn.net/v/SomeVideo/x180-abc.jpg",
            "h120_url": "https://s1.dmcdn.net/v/SomeVideo/x120-abc.jpg",
            "h60_url": "https://s1.dmcdn.net/v/SomeVideo/x60-abc.jpg"
          },
          "preview": {
            "p480_url": "https://vod3.dmcdn.net/p/SomeVideo/x480-xyz.mp4",
            "p360_url": "https://vod3.dmcdn.net/p/SomeVideo/x360-xyz.mp4",
            "p240_url": "https://vod3.dmcdn.net/p/SomeVideo/x240-xyz.mp4"
          }
        }
      },
      "VideoNestedEmbeddingGetResponse": {
        "properties": {
          "enable_embed": {
            "type": "boolean",
            "title": "Enable Embed",
            "description": "Whether embedding is enabled. Writable. (default)",
            "example": true
          }
        },
        "type": "object",
        "title": "Video Nested Embedding Get Response",
        "example": {
          "enable_embed": true
        }
      },
      "VideoNestedThumbnailGetResponse": {
        "properties": {
          "h1080_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "H1080 Url",
            "description": "1080px-height thumbnail URL (default sub-field for ``thumbnail``). (default)",
            "example": "https://s1.dmcdn.net/v/SomeVideo/x1080-YZy.jpg"
          },
          "h720_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "H720 Url",
            "description": "720px-height thumbnail URL.",
            "example": "https://s1.dmcdn.net/v/SomeVideo/x720-YZy.jpg"
          },
          "h480_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "H480 Url",
            "description": "480px-height thumbnail URL.",
            "example": "https://s1.dmcdn.net/v/SomeVideo/x480-YZy.jpg"
          },
          "h360_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "H360 Url",
            "description": "360px-height thumbnail URL.",
            "example": "https://s1.dmcdn.net/v/SomeVideo/x360-YZy.jpg"
          },
          "h240_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "H240 Url",
            "description": "240px-height thumbnail URL.",
            "example": "https://s1.dmcdn.net/v/SomeVideo/x240-YZy.jpg"
          },
          "h180_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "H180 Url",
            "description": "180px-height thumbnail URL.",
            "example": "https://s1.dmcdn.net/v/SomeVideo/x180-YZy.jpg"
          },
          "h120_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "H120 Url",
            "description": "120px-height thumbnail URL.",
            "example": "https://s1.dmcdn.net/v/SomeVideo/x120-YZy.jpg"
          },
          "h62_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "H62 Url",
            "description": "62px-height thumbnail URL.",
            "example": "https://s1.dmcdn.net/v/SomeVideo/x62-YZy.jpg"
          },
          "h60_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "H60 Url",
            "description": "60px-height thumbnail URL.",
            "example": "https://s1.dmcdn.net/v/SomeVideo/x60-YZy.jpg"
          }
        },
        "type": "object",
        "title": "Video Nested Thumbnail Get Response",
        "example": {
          "h1080_url": "https://s1.dmcdn.net/v/SomeVideo/x1080-YZy.jpg",
          "h720_url": "https://s1.dmcdn.net/v/SomeVideo/x720-YZy.jpg",
          "h480_url": "https://s1.dmcdn.net/v/SomeVideo/x480-YZy.jpg",
          "h360_url": "https://s1.dmcdn.net/v/SomeVideo/x360-YZy.jpg",
          "h240_url": "https://s1.dmcdn.net/v/SomeVideo/x240-YZy.jpg",
          "h180_url": "https://s1.dmcdn.net/v/SomeVideo/x180-YZy.jpg",
          "h120_url": "https://s1.dmcdn.net/v/SomeVideo/x120-YZy.jpg",
          "h62_url": "https://s1.dmcdn.net/v/SomeVideo/x62-YZy.jpg",
          "h60_url": "https://s1.dmcdn.net/v/SomeVideo/x60-YZy.jpg"
        }
      },
      "Visibility": {
        "type": "string",
        "enum": [
          "public",
          "private",
          "password"
        ],
        "title": "Visibility",
        "description": "Video visibility status."
      }
    },
    "securitySchemes": {
      "Bearer": {
        "type": "http",
        "description": "JWT token for authentication. Can be retrieved using https://oauth2.dailymotion.com/v1/token",
        "scheme": "bearer"
      }
    }
  },
  "tags": [
    {
      "name": "Video",
      "description": "Video resource — metadata, publication, and optional upload payload."
    }
  ]
}
```