---
updatedAt: 2026-06-24T13:59:16.000Z
agentTools:
  projectIndex: https://developers.dailymotion.com/llms.txt
---

# Get a profile

Fetch one profile by `profile_id`. Use `fields` to limit returned
properties. Requires `profile.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/{id}": {
      "get": {
        "tags": [
          "Profile"
        ],
        "summary": "Get a profile",
        "description": "Fetch one profile by `profile_id`. Use `fields` to limit returned\nproperties. Requires `profile.read`\n[scope](https://developers.dailymotion.com/v2/reference/api-scopes).",
        "operationId": "getProfile",
        "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:** `can_change_name`, `content_defaults`, `created_at`, `description`, `display_name`, `name`, `profile_id`, `social_links`, `webhook`. For embedded objects, use dot notation (e.g. `content_defaults.ai_subtitles`); **Embedded fields:** `content_defaults`, `social_links`, `webhook`.",
              "title": "Fields"
            },
            "description": "Comma-separated field names to include. **Fields:** `can_change_name`, `content_defaults`, `created_at`, `description`, `display_name`, `name`, `profile_id`, `social_links`, `webhook`. For embedded objects, use dot notation (e.g. `content_defaults.ai_subtitles`); **Embedded fields:** `content_defaults`, `social_links`, `webhook`."
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProfileGetResponse"
                }
              }
            }
          },
          "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": {
      "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."
      },
      "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)."
      },
      "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"
          ]
        }
      },
      "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."
      }
    },
    "securitySchemes": {
      "Bearer": {
        "type": "http",
        "description": "JWT token for authentication. Can be retrieved using https://oauth2.dailymotion.com/v1/token",
        "scheme": "bearer"
      }
    }
  },
  "tags": [
    {
      "name": "Profile",
      "description": "Profile (identity, presentation, and default content settings)."
    }
  ]
}
```