Skip to main content
The cinemas endpoint returns all cinemas registered on the Rakcha platform, including their name, address, and operational status.

List all cinemas

GET /api/cinemas
Returns an array of all cinema objects. No query parameters are required.

Request

No request body or query parameters are needed.
curl --request GET \
  --url https://rakcha.example.com/api/cinemas \
  --header 'Authorization: Bearer <token>'

Response fields

Returns a JSON array. Each element has the following fields:
id
integer
Unique numeric identifier for the cinema.
name
string
The display name of the cinema.
address
string
The physical address of the cinema.
status
string
The current operational status of the cinema. One of:
  • open — the cinema is operating normally.
  • closed — the cinema is temporarily or permanently closed.
  • renovation — the cinema is undergoing renovation.

Example response

[
  {
    "id": 1,
    "name": "Cine Tunis",
    "address": "Avenue Habib Bourguiba, Tunis",
    "status": "open"
  },
  {
    "id": 2,
    "name": "Mega Cinema",
    "address": "Centre Comercial, Sfax",
    "status": "renovation"
  }
]

Build docs developers (and LLMs) love