---
updatedAt: 2026-06-25T11:54:29.000Z
---

Fetch the complete documentation index at: https://developers.dailymotion.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# List livestreams for a profile

List livestreams with optional `sort`, filters (status, visibility,
date range, tags, etc.), and `fields`. Default sort is `created_at`
descending. Requires `live.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": {
    "/profiles/{profile_id}/livestreams": {
      "get": {
        "tags": [
          "Livestream"
        ],
        "summary": "List livestreams for a profile",
        "description": "List livestreams with optional `sort`, filters (status, visibility,\ndate range, tags, etc.), and `fields`. Default sort is `created_at`\ndescending. Requires `live.read`\n[scope](https://developers.dailymotion.com/v2/reference/api-scopes).",
        "operationId": "listProfileLivestreams",
        "security": [
          {
            "Bearer": []
          }
        ],
        "parameters": [
          {
            "name": "profile_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Parent resource ID",
              "title": "Profile Id"
            },
            "description": "Parent resource ID"
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1,
              "title": "Page"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 20,
              "title": "Page Size"
            }
          },
          {
            "name": "fields",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Comma-separated field names to include. **Fields:** `advertising`, `category`, `country`, `created_at`, `description`, `embedding`, `enable_comments`, `end_at`, `geo_restriction`, `has_paid_partnership`, `ingest`, `is_ai_altered`, `is_exclusive_content`, `is_explicit`, `is_for_kids`, `language`, `livestream_id`, `livestream_url`, `profile`, `recording`, `start_at`, `status`, `thumbnail`, `title`, `updated_at`, `visibility`. For embedded objects, use dot notation (e.g. `advertising.end_at`); **Embedded fields:** `advertising`, `embedding`, `geo_restriction`, `ingest`, `profile`, `recording`, `status`, `thumbnail`.",
              "title": "Fields"
            },
            "description": "Comma-separated field names to include. **Fields:** `advertising`, `category`, `country`, `created_at`, `description`, `embedding`, `enable_comments`, `end_at`, `geo_restriction`, `has_paid_partnership`, `ingest`, `is_ai_altered`, `is_exclusive_content`, `is_explicit`, `is_for_kids`, `language`, `livestream_id`, `livestream_url`, `profile`, `recording`, `start_at`, `status`, `thumbnail`, `title`, `updated_at`, `visibility`. For embedded objects, use dot notation (e.g. `advertising.end_at`); **Embedded fields:** `advertising`, `embedding`, `geo_restriction`, `ingest`, `profile`, `recording`, `status`, `thumbnail`."
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Comma-separated field names. Prefix with `-` for descending order (e.g. `rating,-created_at`). **Sortable fields:** `created_at`.",
              "title": "Sort"
            },
            "description": "Comma-separated field names. Prefix with `-` for descending order (e.g. `rating,-created_at`). **Sortable fields:** `created_at`."
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/LivestreamStatus",
              "description": "Filter by status (onair, offair)"
            },
            "description": "Filter by status (onair, offair)"
          },
          {
            "name": "visibility",
            "in": "query",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/VisibilityFilter",
              "description": "Filter by visibility (public, private, password)"
            },
            "description": "Filter by visibility (public, private, password)"
          },
          {
            "name": "enable_advertising",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Filter by advertising enabled status",
              "title": "Enable Advertising"
            },
            "description": "Filter by advertising enabled status"
          },
          {
            "name": "is_explicit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Filter by explicit content flag",
              "title": "Is Explicit"
            },
            "description": "Filter by explicit content flag"
          },
          {
            "name": "is_for_kids",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Filter by is_for_kids flag",
              "title": "Is For Kids"
            },
            "description": "Filter by is_for_kids flag"
          },
          {
            "name": "created_after",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time",
              "description": "Filter created after this ISO 8601 date",
              "title": "Created After"
            },
            "description": "Filter created after this ISO 8601 date"
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time",
              "description": "Filter created before this ISO 8601 date",
              "title": "Created Before"
            },
            "description": "Filter created before this ISO 8601 date"
          },
          {
            "name": "tags",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Filter by tags (comma-separated)",
              "title": "Tags"
            },
            "description": "Filter by tags (comma-separated)"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SubProfileLivestreamListResponse"
                }
              }
            }
          },
          "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": {
      "AdvertisingListItemResponse": {
        "properties": {
          "end_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "End At",
            "description": "Estimated ISO 8601 timestamp when the current ad break ends.\n\n``null`` when no ad break is currently running. Commercials are spaced by\nabout 45 seconds. (default)",
            "example": "2023-06-15T14:31:30Z"
          },
          "remaining": {
            "type": "integer",
            "title": "Remaining",
            "description": "Number of ads still available during the current hour (max 24 per hour).\n\nReturns ``0`` when the stream is off-air, ad breaks are unavailable, or the\nhourly quota is exhausted. (default)",
            "example": 12
          }
        },
        "type": "object",
        "title": "AdvertisingListItemResponse",
        "example": {
          "end_at": "2023-06-15T14:31:30Z",
          "remaining": 12
        }
      },
      "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."
      },
      "GeoRestrictionListItemResponse": {
        "properties": {
          "mode": {
            "$ref": "#/components/schemas/GeoRestrictionMode",
            "description": "Whether to allow or deny the listed countries. (default)",
            "example": "allow"
          },
          "countries": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Countries",
            "description": "ISO 3166-1 alpha-2 country codes to allow or deny.\n\nRequired when a ``geo_restriction`` object is provided \n(use ``[]`` for none). (default)",
            "example": [
              "US",
              "FR",
              "DE"
            ]
          }
        },
        "type": "object",
        "title": "GeoRestrictionListItemResponse",
        "example": {
          "mode": "allow",
          "countries": [
            "US",
            "FR",
            "DE"
          ]
        }
      },
      "GeoRestrictionMode": {
        "type": "string",
        "enum": [
          "allow",
          "deny"
        ],
        "title": "GeoRestrictionMode",
        "description": "Geoblocking restriction mode."
      },
      "IngestListItemResponse": {
        "properties": {
          "rtmp_url": {
            "type": "string",
            "title": "Rtmp Url",
            "description": "RTMP ingest URL to configure in your streaming software (e.g. OBS).\nPush your live stream to this URL to start broadcasting.\nRead-only - requires owner authentication. (default)",
            "example": "rtmp://publish.dailymotion.com/publish-dm/x8abc123?auth=KEY789"
          },
          "srt_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Srt Url",
            "description": "SRT ingest URL (read-only).",
            "example": "srt://publish.dailymotion.com:1234?streamid=x8abc123"
          },
          "available_servers": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object",
            "title": "Available Servers",
            "description": "Available ingest servers as a dict of label → RTMP URL (read-only).",
            "example": {
              "Default (recommended)": "rtmp://publish.dailymotion.com/publish-dm"
            }
          }
        },
        "type": "object",
        "title": "IngestListItemResponse",
        "example": {
          "rtmp_url": "rtmp://publish.dailymotion.com/publish-dm/x8abc123?auth=KEY789",
          "srt_url": "srt://publish.dailymotion.com:1234?streamid=x8abc123",
          "available_servers": {
            "Default (recommended)": "rtmp://publish.dailymotion.com/publish-dm"
          }
        }
      },
      "LivestreamNestedEmbeddingListItemResponse": {
        "properties": {
          "enable_embed": {
            "type": "boolean",
            "title": "Enable Embed",
            "description": "Whether embedding is enabled. Writable. (default)",
            "example": true
          },
          "embed_url": {
            "type": "string",
            "title": "Embed Url",
            "description": "Embed URL (read-only). (default)",
            "example": "https://www.dailymotion.com/embed/video/x8abc123"
          },
          "embed_html": {
            "type": "string",
            "title": "Embed Html",
            "description": "Pre-formatted iframe HTML for embedding (read-only).",
            "example": "<iframe src=\"https://www.dailymotion.com/embed/video/x8abc123\">"
          }
        },
        "type": "object",
        "title": "LivestreamNestedEmbeddingListItemResponse",
        "example": {
          "enable_embed": true,
          "embed_url": "https://www.dailymotion.com/embed/video/x8abc123",
          "embed_html": "<iframe src=\"https://www.dailymotion.com/embed/video/x8abc123\">"
        }
      },
      "LivestreamNestedThumbnailListItemResponse": {
        "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/SomeLive/x1080-YZy.jpg"
          },
          "h720_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "H720 Url",
            "description": "720px-height thumbnail URL.",
            "example": "https://s1.dmcdn.net/v/SomeLive/x720-YZy.jpg"
          },
          "h480_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "H480 Url",
            "description": "480px-height thumbnail URL.",
            "example": "https://s1.dmcdn.net/v/SomeLive/x480-YZy.jpg"
          },
          "h240_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "H240 Url",
            "description": "240px-height thumbnail URL.",
            "example": "https://s1.dmcdn.net/v/SomeLive/x240-YZy.jpg"
          },
          "default_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Default Url",
            "description": "Full-size thumbnail URL (respecting aspect ratio).",
            "example": "https://s1.dmcdn.net/v/SomeLive.jpg"
          }
        },
        "type": "object",
        "title": "LivestreamNestedThumbnailListItemResponse",
        "example": {
          "h1080_url": "https://s1.dmcdn.net/v/SomeLive/x1080-YZy.jpg",
          "h720_url": "https://s1.dmcdn.net/v/SomeLive/x720-YZy.jpg",
          "h480_url": "https://s1.dmcdn.net/v/SomeLive/x480-YZy.jpg",
          "h240_url": "https://s1.dmcdn.net/v/SomeLive/x240-YZy.jpg",
          "default_url": "https://s1.dmcdn.net/v/SomeLive.jpg"
        }
      },
      "LivestreamStatus": {
        "type": "string",
        "enum": [
          "onair",
          "offair"
        ],
        "title": "LivestreamStatus",
        "description": "Valid status values for livestream list filtering."
      },
      "ProfileContentDefaultsListItemResponse": {
        "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/GeoRestrictionListItemResponse",
            "description": "Default geo restriction for new videos. (default)",
            "example": "{\"mode\": \"allow\", \"countries\": [\"US\", \"FR\"]}"
          }
        },
        "type": "object",
        "title": "ProfileContentDefaultsListItemResponse",
        "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."
      },
      "ProfileListItemResponse": {
        "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/ProfileSocialLinksListItemResponse",
            "description": "Social links associated with the profile.",
            "example": "{\"twitter_url\": \"https://x.com/mychannel\"}"
          },
          "content_defaults": {
            "$ref": "#/components/schemas/ProfileContentDefaultsListItemResponse",
            "description": "Content default settings for the profile.",
            "example": "{\"language\": \"en\", \"visibility\": \"public\"}"
          },
          "webhook": {
            "$ref": "#/components/schemas/ProfileWebhookListItemResponse",
            "description": "Webhook configuration associated with the profile.",
            "example": "{\"callback_url\": \"https://api.example.com/hooks/dm\",\n\"events\": [\"video.created\"]}"
          }
        },
        "type": "object",
        "title": "ProfileListItemResponse",
        "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"
            ]
          }
        }
      },
      "ProfileSocialLinksListItemResponse": {
        "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": "ProfileSocialLinksListItemResponse",
        "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."
      },
      "ProfileWebhookListItemResponse": {
        "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": "ProfileWebhookListItemResponse",
        "example": {
          "callback_url": "https://api.example.com/v1/webhooks/dailymotion",
          "events": [
            "video.created",
            "video.published"
          ]
        }
      },
      "RecordingListItemResponse": {
        "properties": {
          "auto_record": {
            "type": "boolean",
            "title": "Auto Record",
            "description": "Enable DVR auto-recording. Writable. (default)",
            "example": true
          },
          "status": {
            "$ref": "#/components/schemas/RecordingStatus",
            "description": "Current recording status (read-only).",
            "example": "stopped"
          },
          "start_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Start At",
            "description": "ISO 8601 timestamp when recording started (read-only).",
            "example": "2023-06-15T14:30:00Z"
          },
          "end_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "End At",
            "description": "ISO 8601 timestamp when recording ended (read-only).",
            "example": "2023-06-15T16:00:00Z"
          }
        },
        "type": "object",
        "title": "RecordingListItemResponse",
        "example": {
          "auto_record": true,
          "status": "stopped",
          "start_at": "2023-06-15T14:30:00Z",
          "end_at": "2023-06-15T16:00:00Z"
        }
      },
      "RecordingStatus": {
        "type": "string",
        "enum": [
          "starting",
          "started",
          "stopping",
          "stopped"
        ],
        "title": "RecordingStatus",
        "description": "Livestream DVR recording status."
      },
      "StatusListItemResponse": {
        "properties": {
          "onair": {
            "type": "boolean",
            "title": "Onair",
            "description": "Whether the stream is currently live. (default)",
            "example": true
          },
          "airing_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Airing At",
            "description": "Last time stream went on-air.",
            "example": "2023-06-15T14:30:00Z"
          },
          "audio_bitrate": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Audio Bitrate",
            "description": "Current audio bitrate in bps.",
            "example": 128
          }
        },
        "type": "object",
        "title": "StatusListItemResponse",
        "example": {
          "onair": true,
          "airing_at": "2023-06-15T14:30:00Z",
          "audio_bitrate": 128
        }
      },
      "SubProfileLivestreamListItemResponse": {
        "properties": {
          "livestream_id": {
            "type": "string",
            "title": "Livestream Id",
            "description": "Unique identifier for the livestream. (default)",
            "example": "x1y2z3"
          },
          "title": {
            "type": "string",
            "title": "Title",
            "description": "Title of the livestream. Cannot be blank. Maximum 255 characters.\n\nRequired when creating a livestream. (default)",
            "example": "Live Q&A with the Dev Team"
          },
          "livestream_url": {
            "type": "string",
            "title": "Livestream Url",
            "description": "Canonical Dailymotion URL for this livestream. (default)",
            "example": "https://www.dailymotion.com/video/x8abc123"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description",
            "description": "Optional description of the livestream. Supports HTML.\nMaximum 3000 characters.",
            "example": "Join us for a live Q&A session!"
          },
          "language": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Language",
            "description": "ISO 639-1 language code (e.g. en, fr).",
            "example": "en"
          },
          "category": {
            "$ref": "#/components/schemas/VideoCategory",
            "description": "Content category used for discovery and reporting.\n\nRequired when creating a livestream.",
            "example": "tech"
          },
          "country": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Country",
            "description": "ISO 3166-1 alpha-2 country code (e.g. US, FR).",
            "example": "US"
          },
          "visibility": {
            "$ref": "#/components/schemas/Visibility",
            "description": "Who can watch the livestream.\n\nValues: `public`, `private`, or `password`.\nRequired when creating a livestream.",
            "example": "public"
          },
          "is_for_kids": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Is For Kids",
            "description": "Whether the livestream is made for kids (COPPA). Required on create.",
            "example": false
          },
          "is_explicit": {
            "type": "boolean",
            "title": "Is Explicit",
            "description": "Whether the livestream is explicit.\n\n**Warning** This flag cannot be removed once set.",
            "example": false
          },
          "is_exclusive_content": {
            "type": "boolean",
            "title": "Is Exclusive Content",
            "description": "Whether the livestream is exclusive to Dailymotion.",
            "example": false
          },
          "is_ai_altered": {
            "type": "boolean",
            "title": "Is Ai Altered",
            "description": "Whether the livestream content was altered with AI.",
            "example": false
          },
          "has_paid_partnership": {
            "type": "boolean",
            "title": "Has Paid Partnership",
            "description": "Whether the livestream discloses a paid partnership.",
            "example": false
          },
          "enable_comments": {
            "type": "boolean",
            "title": "Enable Comments",
            "description": "Whether comments are enabled on this livestream.",
            "example": true
          },
          "profile": {
            "$ref": "#/components/schemas/ProfileListItemResponse",
            "description": "Profile that owns this livestream.",
            "example": "{\"profile_id\": \"x1y2z3\"}"
          },
          "start_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Start At",
            "description": "ISO 8601 timestamp when the stream started (or is scheduled to start).",
            "example": "2023-06-15T14:30:00Z"
          },
          "end_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "End At",
            "description": "ISO 8601 timestamp when the stream ended (or is scheduled to end).",
            "example": "2023-06-15T16:00:00Z"
          },
          "ingest": {
            "$ref": "#/components/schemas/IngestListItemResponse",
            "description": "Ingest configuration for streaming software (read-only).",
            "example": "{\"rtmp_url\": \"rtmp://publish.dailymotion.com/publish-dm/x8abc\"}"
          },
          "status": {
            "$ref": "#/components/schemas/StatusListItemResponse",
            "description": "Current livestream status fields (all read-only).",
            "example": "{\"onair\": true, \"airing_at\": \"2023-06-15T14:30:00Z\"}"
          },
          "recording": {
            "$ref": "#/components/schemas/RecordingListItemResponse",
            "description": "Recording configuration and status.",
            "example": "{\"auto_record\": true, \"status\": \"started\"}"
          },
          "geo_restriction": {
            "$ref": "#/components/schemas/GeoRestrictionListItemResponse",
            "description": "Geo-restriction settings. Optional at creation; when provided, both\n``mode`` and ``countries`` must be supplied.",
            "example": "{\"mode\": \"allow\", \"countries\": [\"US\", \"FR\"]}"
          },
          "embedding": {
            "$ref": "#/components/schemas/LivestreamNestedEmbeddingListItemResponse",
            "description": "Embedding settings for the live player.",
            "example": "{\"enable_embed\": true,\n\"embed_url\": \"https://www.dailymotion.com/embed/video/x8abc123\"}"
          },
          "advertising": {
            "$ref": "#/components/schemas/AdvertisingListItemResponse",
            "description": "Live advertising status (read-only).",
            "example": "{\"end_at\": \"2023-06-15T14:31:30Z\", \"remaining\": 12}"
          },
          "thumbnail": {
            "$ref": "#/components/schemas/LivestreamNestedThumbnailListItemResponse",
            "description": "Thumbnail stills at multiple heights (read-only).\n\nWhen ``?fields=thumbnail`` is used without sub-fields, only ``h1080_url``\nis included.",
            "example": "{\"h1080_url\": \"https://s1.dmcdn.net/v/SomeLive/x1080-YZy.jpg\"}"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At",
            "description": "ISO 8601 timestamp when the livestream was created. (default)",
            "example": "2023-06-15T14:30:00Z"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "title": "Updated At",
            "description": "ISO 8601 timestamp when the livestream was last updated.",
            "example": "2023-06-15T15:00:00Z"
          }
        },
        "type": "object",
        "title": "SubProfileLivestreamListItemResponse",
        "example": {
          "livestream_id": "x1y2z3",
          "title": "Live Q&A with the Dev Team",
          "livestream_url": "https://www.dailymotion.com/video/x8abc123",
          "description": "Join us for a live Q&A session!",
          "language": "en",
          "category": "tech",
          "country": "US",
          "visibility": "public",
          "is_for_kids": false,
          "is_explicit": false,
          "is_exclusive_content": false,
          "is_ai_altered": false,
          "has_paid_partnership": false,
          "enable_comments": true,
          "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"
              ]
            }
          },
          "start_at": "2023-06-15T14:30:00Z",
          "end_at": "2023-06-15T16:00:00Z",
          "ingest": {
            "rtmp_url": "rtmp://publish.dailymotion.com/publish-dm/x8abc123?auth=KEY789",
            "srt_url": "srt://publish.dailymotion.com:1234?streamid=x8abc123",
            "available_servers": {
              "Default (recommended)": "rtmp://publish.dailymotion.com/publish-dm"
            }
          },
          "status": {
            "onair": true,
            "airing_at": "2023-06-15T14:30:00Z",
            "audio_bitrate": 128
          },
          "recording": {
            "auto_record": true,
            "status": "stopped",
            "start_at": "2023-06-15T14:30:00Z",
            "end_at": "2023-06-15T16:00:00Z"
          },
          "geo_restriction": {
            "mode": "allow",
            "countries": [
              "US",
              "FR",
              "DE"
            ]
          },
          "embedding": {
            "enable_embed": true,
            "embed_url": "https://www.dailymotion.com/embed/video/x8abc123",
            "embed_html": "<iframe src=\"https://www.dailymotion.com/embed/video/x8abc123\">"
          },
          "advertising": {
            "end_at": "2023-06-15T14:31:30Z",
            "remaining": 12
          },
          "thumbnail": {
            "h1080_url": "https://s1.dmcdn.net/v/SomeLive/x1080-YZy.jpg",
            "h720_url": "https://s1.dmcdn.net/v/SomeLive/x720-YZy.jpg",
            "h480_url": "https://s1.dmcdn.net/v/SomeLive/x480-YZy.jpg",
            "h240_url": "https://s1.dmcdn.net/v/SomeLive/x240-YZy.jpg",
            "default_url": "https://s1.dmcdn.net/v/SomeLive.jpg"
          },
          "created_at": "2023-06-15T14:30:00Z",
          "updated_at": "2023-06-15T15:00:00Z"
        }
      },
      "SubProfileLivestreamListResponse": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/SubProfileLivestreamListItemResponse"
            },
            "type": "array",
            "title": "Data"
          },
          "pagination": {
            "$ref": "#/components/schemas/SubProfileLivestreamListResponsePagination"
          }
        },
        "type": "object",
        "required": [
          "data",
          "pagination"
        ],
        "title": "SubProfileLivestreamListResponse",
        "example": {
          "data": [
            {
              "livestream_id": "x1y2z3",
              "title": "Live Q&A with the Dev Team",
              "livestream_url": "https://www.dailymotion.com/video/x8abc123",
              "description": "Join us for a live Q&A session!",
              "language": "en",
              "category": "tech",
              "country": "US",
              "visibility": "public",
              "is_for_kids": false,
              "is_explicit": false,
              "is_exclusive_content": false,
              "is_ai_altered": false,
              "has_paid_partnership": false,
              "enable_comments": true,
              "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"
                  ]
                }
              },
              "start_at": "2023-06-15T14:30:00Z",
              "end_at": "2023-06-15T16:00:00Z",
              "ingest": {
                "rtmp_url": "rtmp://publish.dailymotion.com/publish-dm/x8abc123?auth=KEY789",
                "srt_url": "srt://publish.dailymotion.com:1234?streamid=x8abc123",
                "available_servers": {
                  "Default (recommended)": "rtmp://publish.dailymotion.com/publish-dm"
                }
              },
              "status": {
                "onair": true,
                "airing_at": "2023-06-15T14:30:00Z",
                "audio_bitrate": 128
              },
              "recording": {
                "auto_record": true,
                "status": "stopped",
                "start_at": "2023-06-15T14:30:00Z",
                "end_at": "2023-06-15T16:00:00Z"
              },
              "geo_restriction": {
                "mode": "allow",
                "countries": [
                  "US",
                  "FR",
                  "DE"
                ]
              },
              "embedding": {
                "enable_embed": true,
                "embed_url": "https://www.dailymotion.com/embed/video/x8abc123",
                "embed_html": "<iframe src=\"https://www.dailymotion.com/embed/video/x8abc123\">"
              },
              "advertising": {
                "end_at": "2023-06-15T14:31:30Z",
                "remaining": 12
              },
              "thumbnail": {
                "h1080_url": "https://s1.dmcdn.net/v/SomeLive/x1080-YZy.jpg",
                "h720_url": "https://s1.dmcdn.net/v/SomeLive/x720-YZy.jpg",
                "h480_url": "https://s1.dmcdn.net/v/SomeLive/x480-YZy.jpg",
                "h240_url": "https://s1.dmcdn.net/v/SomeLive/x240-YZy.jpg",
                "default_url": "https://s1.dmcdn.net/v/SomeLive.jpg"
              },
              "created_at": "2023-06-15T14:30:00Z",
              "updated_at": "2023-06-15T15:00:00Z"
            }
          ],
          "pagination": {
            "page": 1,
            "page_size": 20,
            "total": 42,
            "next": "https://api.dailymotion.com/v2/resources?page=2&page_size=20",
            "previous": null
          }
        }
      },
      "SubProfileLivestreamListResponsePagination": {
        "properties": {
          "page": {
            "type": "integer",
            "title": "Page",
            "description": "Current page number (1-indexed).",
            "examples": [
              1
            ]
          },
          "page_size": {
            "type": "integer",
            "title": "Page Size",
            "description": "Number of items per page.",
            "examples": [
              20
            ]
          },
          "total": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Total",
            "description": "Total number of items across all pages, or null if unknown. Informational only: it may be a lower bound on large result sets. Use `next` to paginate, never `total`.",
            "examples": [
              42
            ]
          },
          "next": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next",
            "description": "URL for the next page of results, or null when no further page is reachable. Treat it as opaque: follow it, do not build it yourself, as its shape may change.",
            "examples": [
              "/videos?page=2&page_size=20"
            ]
          },
          "previous": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Previous",
            "description": "URL for the previous page of results, or null if on the first page. Opaque, like `next`.",
            "examples": [
              null
            ]
          }
        },
        "type": "object",
        "required": [
          "page",
          "page_size",
          "total",
          "next",
          "previous"
        ],
        "title": "SubProfileLivestreamListResponsePagination",
        "example": {
          "next": "https://api.dailymotion.com/v2/resources?page=2&page_size=20",
          "page": 1,
          "page_size": 20,
          "total": 42
        }
      },
      "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."
      },
      "Visibility": {
        "type": "string",
        "enum": [
          "public",
          "private",
          "password"
        ],
        "title": "Visibility",
        "description": "Video visibility status."
      },
      "VisibilityFilter": {
        "type": "string",
        "enum": [
          "public",
          "private",
          "password"
        ],
        "title": "VisibilityFilter",
        "description": "Valid visibility values for list filtering."
      }
    },
    "securitySchemes": {
      "Bearer": {
        "type": "http",
        "description": "JWT token for authentication. Can be retrieved using https://oauth2.dailymotion.com/v1/token",
        "scheme": "bearer"
      }
    }
  },
  "tags": [
    {
      "name": "Livestream",
      "description": "Live broadcast configuration, ingest hints, status, and related options.\n\nCovers recording, embedding, and live advertising status."
    }
  ]
}
```