Skip to main content
The Rakcha API is a REST API that gives you programmatic access to cinema listings, films, TV series, e-commerce products, and user authentication. All requests and responses use JSON.

​
Base URL

https://rakcha.example.com
All endpoints are prefixed with /api. There is currently one version of the API; no version segment appears in the URL.

​
Request format

Send request bodies as JSON with the Content-Type: application/json header. Query parameters are not used for filtering on the current endpoints.

​
Response format

All responses are JSON. Successful list endpoints return a JSON array. The authentication endpoint returns a JSON object.

​
Authentication

Most endpoints require a valid JWT bearer token. Obtain a token by calling POST /api/users/auth with your email and password. Pass the token in the Authorization header on all subsequent requests: 
Authorization: Bearer <token>
See Authentication for full details.

​
HTTP status codes

CodeMeaning
200Request succeeded.
201Resource created.
400Bad request — malformed JSON or missing required fields.
401Unauthorized — missing or invalid bearer token.
403Forbidden — authenticated but insufficient permissions.
404Not found — the requested resource does not exist.
422Unprocessable entity — validation failed on the submitted data.
500Internal server error — unexpected server-side failure.

​
OpenAPI specification

A machine-readable OpenAPI 3.0 spec is available at: 
shared/api-spec/openapi.yaml

​
Quick example

curl --request GET \
  --url https://rakcha.example.com/api/films \
  --header 'Authorization: Bearer <token>'

​
Available resources

Authentication

Obtain a JWT token by authenticating with email and password.

Cinemas

Retrieve the list of registered cinemas and their statuses.

Films

Browse the full film catalogue with titles, descriptions, and categories.

Series

Access TV series data including summaries and season counts.

Products

List e-commerce products available in the Rakcha store.

Users

Authenticate users and retrieve account information.

Build docs developers (and LLMs) love

Get started for freeTalk to us