Guides

Movies

Include the Accept-Language header on all endpoints here: en | km | cn.

GET /v1/movies/search

Search movies with paging and sorting.

Query

• limit (number, default 10)
• offset (number, default 0)
• searchText (string)
• sort (string: latest-released | early-released | a-z | z-a)

Headers

• Accept-Language (required)

Response — 200

Code
 
{
  "count": 1,
  "rows": [
    /* MovieDto[] */
  ]
}

Example

Code
 
curl -X GET "https://api.wml.staging.nexdots.com/v1/movies/search?limit=10&offset=0&sort=a-z&searchText=avatar"   -H "Accept-Language: en"   -H "Authorization: Bearer <JWT>"

---

GET /v1/movies/coming-soon

List coming-soon titles.

Query

• limit (number, default 10)
• offset (number, default 0)
• sort (default a-z if not provided)
• date (ISO datetime)
• cinemaProvider (legend | fable)
• cinemaCodes (string[])

Headers

• Accept-Language (required)

Response — 200

Code
 
{
  "count": 1,
  "rows": [
    /* MovieDto[] */
  ]
}

Example

Code
 
curl -G "https://api.wml.staging.nexdots.com/v1/movies/coming-soon"   -H "Accept-Language: en"   --data-urlencode "limit=10"   --data-urlencode "cinemaProvider=legend"

---

GET /v1/movies/now-showing

Now-playing titles (optional filter by attributes or location/date).

Query

• limit (number, default 10)
• offset (number, default 0)
• sort (latest-released | early-released | a-z | z-a)
• date (ISO datetime)
• cinemaProvider (legend | fable)
• cinemaCodes (string[])
• attributes (string[]: 2D | 3D | ScreenX | ATMOS)

Headers

• Accept-Language (required)

Response — 200

Code
 
{
  "count": 1,
  "rows": [
    /* MovieDto[] */
  ]
}

Example

Code
 
curl -G "https://api.wml.staging.nexdots.com/v1/movies/now-showing"   -H "Accept-Language: en"   --data-urlencode "attributes=ATMOS"   --data-urlencode "cinemaProvider=legend"

---

GET /v1/movies/advanced-ticket

Titles with advance booking.

Query

• limit (number, default 10)
• offset (number, default 0)
• sort (default a-z)
• date (ISO datetime)
• cinemaProvider (legend | fable)
• cinemaCodes (string[])
• attributes (2D | 3D | ScreenX | ATMOS)

Headers

• Accept-Language (required)

Response — 200

Code
 
{
  "count": 1,
  "rows": [
    /* MovieDto[] */
  ]
}

Example

Code
 
curl -G "https://api.wml.staging.nexdots.com/v1/movies/advanced-ticket"   -H "Accept-Language: en"   --data-urlencode "sort=latest-released"

---

GET /v1/movies/featured

Featured movies.

Headers

• Accept-Language (required)

Response — 200

Code
 
[
  /* MovieDto[] */
]

Example

Code
 
curl -X GET "https://api.wml.staging.nexdots.com/v1/movies/featured"   -H "Accept-Language: en"

---

GET /v1/movies/filter-date

Dates that have sessions (optional by cinema provider / movie / date anchor).

Query

• cinemaProvider (legend | fable)
• date (ISO datetime)
• movieId (string)

Headers

• Accept-Language (required)

Response — 200

Code
 
[{ "date": "2025-10-24T00:00:00Z", "hasSession": true }]

Example

Code
 
curl -G "https://api.wml.staging.nexdots.com/v1/movies/filter-date"   -H "Accept-Language: en"   --data-urlencode "cinemaProvider=legend"

---

GET /v1/movies/filter-month

Calendar-style month availability.

Query

• date (ISO datetime; any day within target month)

Headers

• Accept-Language (required)

Response — 200

Code
 
[
  /* ScheduledFilmSessionDateDto[] */
]

Example

Code
 
curl -G "https://api.wml.staging.nexdots.com/v1/movies/filter-month"   -H "Accept-Language: en"   --data-urlencode "date=2025-10-01T00:00:00Z"

---

GET /v1/movies/{id}

Movie detail.

Path

• id (string)

Headers

• Accept-Language (required)

Response — 200

Code
 
/* MovieDto */

Example

Code
 
curl -X GET "https://api.wml.staging.nexdots.com/v1/movies/<movieId>"   -H "Accept-Language: en"

---

GET /v1/movies/{id}/showtimes

Grouped showtimes for a movie.

Path

• id (string)

Query

• cinemaProvider (required: legend | fable)
• date (ISO datetime)
• latitude (number)
• longitude (number)
• cinemaCodes (string[])
• attributes (string[]: 2D | 3D | ScreenX | ATMOS)

Headers

• Accept-Language (required)

Response — 200

Code
 
/* FilmSessionGroupDetailDto */

Example

Code
 
curl -G "https://api.wml.staging.nexdots.com/v1/movies/<movieId>/showtimes"   -H "Accept-Language: en"   --data-urlencode "cinemaProvider=legend"   --data-urlencode "date=2025-10-24T00:00:00Z"