Get Movie by ID

Retrieve a specific movie by its ID

GET /movies/:id

Get Movie by ID

cURL

curl --request GET \
  --url https://api.example.com/movies/:id

200

{
  "id_movie": 15,
  "title": "The Neural Canvas",
  "description": "An experimental exploration of machine learning and visual art",
  "duration": 110,
  "main_language": "French",
  "release_year": 2025,
  "nationality": "Belgium",
  "display_picture": "poster-1710234567-987654321.jpg",
  "picture1": "thumbnail1-1710234567-987654321.jpg",
  "picture2": "thumbnail2-1710234567-987654321.jpg",
  "picture3": "thumbnail3-1710234567-987654321.jpg",
  "trailer": "filmFile-1710234567-987654321.mp4",
  "youtube_link": null,
  "production": "Fully AI-Generated",
  "workshop": "Generative Art Techniques",
  "translation": "English",
  "synopsis": "Une exploration expérimentale de l'apprentissage automatique et de l'art visuel",
  "synopsis_anglais": "An experimental exploration of machine learning and visual art",
  "subtitle": "subtitlesSrt-1710234567-987654321.srt",
  "ai_tool": "Stable Diffusion, Pika Labs",
  "thumbnail": "poster-1710234567-987654321.jpg",
  "selection_status": "candidate",
  "jury_comment": "Outstanding visual creativity and innovative use of AI",
  "admin_comment": "Strong candidate for Best AI Film award",
  "id_user": 78,
  "createdAt": "2025-02-15T08:45:00.000Z",
  "updatedAt": "2025-03-06T16:30:00.000Z",
  "Categories": [
    {
      "id_categorie": 2,
      "name": "Visual Art"
    },
    {
      "id_categorie": 3,
      "name": "AI-Generated"
    }
  ],
  "Collaborators": [
    {
      "id_collaborator": 12,
      "first_name": "Thomas",
      "last_name": "Laurent",
      "email": "[e-mail]",
      "job": "AI Artist"
    },
    {
      "id_collaborator": 15,
      "first_name": "Emma",
      "last_name": "Rousseau",
      "email": "[e-mail]",
      "job": "Creative Director"
    }
  ],
  "Awards": [
    {
      "id_award": 3,
      "name": "Best Visual Effects",
      "awarded_at": "2025-03-05T00:00:00.000Z"
    }
  ],
  "Producer": {
    "id_user": 78,
    "first_name": "Lucas",
    "last_name": "Moreau"
  },
  "Juries": [
    {
      "id_user": 10,
      "first_name": "Claire",
      "last_name": "Dubois",
      "email": "[e-mail]",
      "role": "JURY"
    },
    {
      "id_user": 12,
      "first_name": "Marc",
      "last_name": "Lefebvre",
      "email": "[e-mail]",
      "role": "JURY"
    }
  ]
}

Overview

Returns detailed information about a single movie, including all associated categories, collaborators, awards, producer details, and assigned juries.

Authentication

No authentication required. This endpoint is public.

Path Parameters

id · integer · required

The unique identifier of the movie

Response

Returns a single movie object with full details.

id_movie · integer

Unique movie identifier

title · string · required

Movie title

description · text

Movie description/synopsis

duration · integer

Duration in seconds

main_language · string

Main language of the film

release_year · integer

Year of release

nationality · string

Country of origin

display_picture · string

Main display image filename

picture1 · string

First thumbnail filename

picture2 · string

Second thumbnail filename

picture3 · string

Third thumbnail filename

trailer · string

Trailer video filename

youtube_link · string

YouTube video link

production · string

Production company or AI classification

workshop · string

Workshop or AI methodology

translation · string

Translation language

synopsis · text

Synopsis in French

synopsis_anglais · text

Synopsis in English

subtitle · string

Subtitle file (SRT format)

ai_tool · string

AI tools used in production

thumbnail · string

Auto-generated thumbnail from video

selection_status · enum · required

Current status: submitted, assigned, to_discuss, candidate, awarded, refused, selected, finalist

jury_comment · text

Feedback from jury

admin_comment · text

Internal admin notes

id_user · integer · required

Producer user ID

Categories · array

Array of category objects

Collaborators · array

Array of collaborator objects with first_name, last_name, email, job

Awards · array

Array of awards won

Producer · object

Producer info: id_user, first_name, last_name

Juries · array

Assigned jury members

200

{
  "id_movie": 15,
  "title": "The Neural Canvas",
  "description": "An experimental exploration of machine learning and visual art",
  "duration": 110,
  "main_language": "French",
  "release_year": 2025,
  "nationality": "Belgium",
  "display_picture": "poster-1710234567-987654321.jpg",
  "picture1": "thumbnail1-1710234567-987654321.jpg",
  "picture2": "thumbnail2-1710234567-987654321.jpg",
  "picture3": "thumbnail3-1710234567-987654321.jpg",
  "trailer": "filmFile-1710234567-987654321.mp4",
  "youtube_link": null,
  "production": "Fully AI-Generated",
  "workshop": "Generative Art Techniques",
  "translation": "English",
  "synopsis": "Une exploration expérimentale de l'apprentissage automatique et de l'art visuel",
  "synopsis_anglais": "An experimental exploration of machine learning and visual art",
  "subtitle": "subtitlesSrt-1710234567-987654321.srt",
  "ai_tool": "Stable Diffusion, Pika Labs",
  "thumbnail": "poster-1710234567-987654321.jpg",
  "selection_status": "candidate",
  "jury_comment": "Outstanding visual creativity and innovative use of AI",
  "admin_comment": "Strong candidate for Best AI Film award",
  "id_user": 78,
  "createdAt": "2025-02-15T08:45:00.000Z",
  "updatedAt": "2025-03-06T16:30:00.000Z",
  "Categories": [
    {
      "id_categorie": 2,
      "name": "Visual Art"
    },
    {
      "id_categorie": 3,
      "name": "AI-Generated"
    }
  ],
  "Collaborators": [
    {
      "id_collaborator": 12,
      "first_name": "Thomas",
      "last_name": "Laurent",
      "email": "[e-mail]",
      "job": "AI Artist"
    },
    {
      "id_collaborator": 15,
      "first_name": "Emma",
      "last_name": "Rousseau",
      "email": "[e-mail]",
      "job": "Creative Director"
    }
  ],
  "Awards": [
    {
      "id_award": 3,
      "name": "Best Visual Effects",
      "awarded_at": "2025-03-05T00:00:00.000Z"
    }
  ],
  "Producer": {
    "id_user": 78,
    "first_name": "Lucas",
    "last_name": "Moreau"
  },
  "Juries": [
    {
      "id_user": 10,
      "first_name": "Claire",
      "last_name": "Dubois",
      "email": "[e-mail]",
      "role": "JURY"
    },
    {
      "id_user": 12,
      "first_name": "Marc",
      "last_name": "Lefebvre",
      "email": "[e-mail]",
      "role": "JURY"
    }
  ]
}

Error Responses

404

{
  "error": "Film non trouvé"
}

500

{
  "error": "Internal server error"
}