Get video custom fields

Lists all custom fields (key-value metadata) attached to a video. Returns an array; each item has id, key, value, and timestamps.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

GET /videos/{video_id}?custom_fields

Returns all custom fields attached to a specific video. Custom fields are key-value pairs that let you attach arbitrary metadata to videos (e.g., category, priority, internal IDs).

📘

Authorization

Requires a valid Panda API token sent in the Authorization header (no Bearer prefix).

HTTP Method & Path

GET /videos/{video_id}?custom_fields

Base URL: https://api-v2.pandavideo.com.br

Authentication Requirements

Security SchemeHeaderNote
API KeyAuthorizationPanda API token (without Bearer prefix)

Parameters

NameInTypeRequiredDescription
AuthorizationheaderstringYesPanda API token (without Bearer prefix)

Path Parameters

FieldTypeRequiredDescriptionConstraints
video_idstring (uuid)YesID of the video whose custom fields to list.uuid

Query Parameters

FieldTypeRequiredDescriptionConstraints
custom_fieldsstringYesSentinel flag — must be present (no value).flag (empty/no value)

Response

Success Response (200)

Returns an array of custom fields:

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "video_id": "d848feb5-b5a2-4e59-a125-23379b3692b5",
    "key": "category",
    "value": "Educational",
    "created_at": "2026-05-29T10:30:00.000Z",
    "updated_at": "2026-05-29T10:30:00.000Z"
  }
]

Response Schema (item)

FieldTypeDescription
idstring (uuid)ID of the custom field. Use with PUT/DELETE.
video_idstring (uuid)ID of the video this field belongs to.
keystringCustom field key (1–200 chars, alphanumeric).
valuestringCustom field value (max 500 chars).
created_atstringISO 8601 timestamp.
updated_atstringISO 8601 timestamp.

Error Responses

  • 401 Unauthorized — Missing or invalid API token.
  • 404 Not Found — Video not found.
  • 500 Internal Server Error — Server-side error.

Example Usage

cURL

curl -X GET \
  'https://api-v2.pandavideo.com.br/videos/<video_id>?custom_fields' \
  -H 'Authorization: your_api_token_here' \
  -H 'Accept: application/json'

Recipes

Path Params
uuid
required

Unique identifier for the video

Query Params
string
enum
required

Set to 'true' to retrieve custom fields

Allowed:
Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json