Get Movies

Retrieve all movies submitted to the festival

GET /movies

Get Movies

cURL

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

[
  {
    "id_movie": 1,
    "title": "AI Dreams",
    "description": "A short film exploring the intersection of artificial intelligence and human creativity",
    "duration": 90,
    "main_language": "English",
    "release_year": 2025,
    "nationality": "France",
    "display_picture": "poster-1234567890-123456789.jpg",
    "picture1": "thumbnail1-1234567890-123456789.jpg",
    "picture2": "thumbnail2-1234567890-123456789.jpg",
    "picture3": "thumbnail3-1234567890-123456789.jpg",
    "trailer": "filmFile-1234567890-123456789.mp4",
    "youtube_link": "https://youtube.com/watch?v=example",
    "production": "Independent",
    "workshop": "MarsAI Workshop 2025",
    "translation": "French",
    "synopsis": "Un court métrage explorant l'intersection entre l'intelligence artificielle et la créativité humaine",
    "synopsis_anglais": "A short film exploring the intersection of artificial intelligence and human creativity",
    "subtitle": "subtitlesSrt-1234567890-123456789.srt",
    "ai_tool": "Runway ML, Midjourney",
    "thumbnail": "poster-1234567890-123456789.jpg",
    "selection_status": "assigned",
    "jury_comment": null,
    "admin_comment": null,
    "id_user": 42,
    "createdAt": "2025-03-01T10:30:00.000Z",
    "updatedAt": "2025-03-05T14:20:00.000Z",
    "Categories": [
      {
        "id_categorie": 1,
        "name": "Experimental"
      },
      {
        "id_categorie": 3,
        "name": "AI-Generated"
      }
    ],
    "Collaborators": [
      {
        "id_collaborator": 5,
        "first_name": "Marie",
        "last_name": "Dupont",
        "email": "[e-mail]",
        "job": "Director"
      },
      {
        "id_collaborator": 8,
        "first_name": "Jean",
        "last_name": "Martin",
        "email": "[e-mail]",
        "job": "Sound Designer"
      }
    ],
    "Awards": [],
    "Producer": {
      "id_user": 42,
      "first_name": "Sophie",
      "last_name": "Bernard"
    },
    "Juries": [
      {
        "id_user": 10,
        "first_name": "Claire",
        "last_name": "Dubois",
        "email": "[e-mail]",
        "role": "JURY"
      }
    ]
  }
]

Overview

Returns a list of all movies with their associated categories, collaborators, awards, producer information, and assigned juries.

Authentication

No authentication required. This endpoint is public.

Response

Returns an array of movie objects with full details.

movies · array

Array of movie objects

Show Movie Object

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 in selection process: 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

createdAt · datetime

Creation timestamp

updatedAt · datetime

Last update timestamp

Categories · array

Array of category objects associated with this movie

Collaborators · array

Array of collaborator objects (crew members)

Awards · array

Array of awards won by this movie

Producer · object

Producer information object with id_user, first_name, last_name

Juries · array

Array of jury members assigned to review this movie

[
  {
    "id_movie": 1,
    "title": "AI Dreams",
    "description": "A short film exploring the intersection of artificial intelligence and human creativity",
    "duration": 90,
    "main_language": "English",
    "release_year": 2025,
    "nationality": "France",
    "display_picture": "poster-1234567890-123456789.jpg",
    "picture1": "thumbnail1-1234567890-123456789.jpg",
    "picture2": "thumbnail2-1234567890-123456789.jpg",
    "picture3": "thumbnail3-1234567890-123456789.jpg",
    "trailer": "filmFile-1234567890-123456789.mp4",
    "youtube_link": "https://youtube.com/watch?v=example",
    "production": "Independent",
    "workshop": "MarsAI Workshop 2025",
    "translation": "French",
    "synopsis": "Un court métrage explorant l'intersection entre l'intelligence artificielle et la créativité humaine",
    "synopsis_anglais": "A short film exploring the intersection of artificial intelligence and human creativity",
    "subtitle": "subtitlesSrt-1234567890-123456789.srt",
    "ai_tool": "Runway ML, Midjourney",
    "thumbnail": "poster-1234567890-123456789.jpg",
    "selection_status": "assigned",
    "jury_comment": null,
    "admin_comment": null,
    "id_user": 42,
    "createdAt": "2025-03-01T10:30:00.000Z",
    "updatedAt": "2025-03-05T14:20:00.000Z",
    "Categories": [
      {
        "id_categorie": 1,
        "name": "Experimental"
      },
      {
        "id_categorie": 3,
        "name": "AI-Generated"
      }
    ],
    "Collaborators": [
      {
        "id_collaborator": 5,
        "first_name": "Marie",
        "last_name": "Dupont",
        "email": "[e-mail]",
        "job": "Director"
      },
      {
        "id_collaborator": 8,
        "first_name": "Jean",
        "last_name": "Martin",
        "email": "[e-mail]",
        "job": "Sound Designer"
      }
    ],
    "Awards": [],
    "Producer": {
      "id_user": 42,
      "first_name": "Sophie",
      "last_name": "Bernard"
    },
    "Juries": [
      {
        "id_user": 10,
        "first_name": "Claire",
        "last_name": "Dubois",
        "email": "[e-mail]",
        "role": "JURY"
      }
    ]
  }
]

Error Responses

error · string

Error message

name · string

Error type

detail · string

Detailed error information from database

500

{
  "error": "Database connection failed",
  "name": "SequelizeConnectionError",
  "detail": "Connection timeout"
}