> ## Documentation Index > Fetch the complete documentation index at: https://docs.sdk.anghami.com/llms.txt > Use this file to discover all available pages before exploring further. # GetMovie > GetMovie retrieves a single movie by its unique identifier. ## OpenAPI ````yaml /api/anghami-sdk.openapi.yaml get /v1/video/movies/{id} openapi: 3.1.0 info: title: Anghami + OSN+ SDK description: >- Unified OpenAPI bundle covering all Anghami + OSN+ SDK services (music + video streaming). contact: name: Anghami Developer Platform email: developers@anghami.com version: 1.0.0 servers: - url: https://sdk.anghami.com security: [] paths: /v1/video/movies/{id}: get: tags: - VideoCatalogService summary: GetMovie description: GetMovie retrieves a single movie by its unique identifier. operationId: GetMovie parameters: - name: Authorization in: header description: >- OAuth 2.0 Bearer token for user-authenticated requests. Format: Bearer . Optional if x-api-key is provided. required: false schema: type: string example: Bearer eyJhbGciOiJSUzI1NiIs... - name: x-api-key in: header description: >- API key for server-to-server access without user context. Optional if Authorization is provided. required: false schema: type: string example: ang_live_... - name: Accept-Language in: header description: >- Preferred locale for localized content (BCP 47). Determines which language variant is returned for LocalizedString fields. required: false schema: type: string example: ar - name: id in: path description: Unique identifier of the movie to retrieve. required: true schema: type: string responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/sdk_video_v1_GetMovieResponse' '400': description: Validation error content: application/json: schema: $ref: '#/components/schemas/ValidationError' default: description: Error response content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: sdk_video_v1_GetMovieResponse: type: object properties: movie: $ref: '#/components/schemas/sdk_video_v1_Movie' description: GetMovieResponse is the response message containing the requested movie. ValidationError: type: object properties: violations: type: array items: $ref: '#/components/schemas/FieldViolation' description: List of validation violations required: - violations description: >- ValidationError is returned when request validation fails. It contains a list of field violations describing what went wrong. Error: type: object properties: message: type: string description: Error message (e.g., 'user not found', 'database connection failed') description: >- Error is returned when a handler encounters an error. It contains a simple error message that the developer can customize. sdk_video_v1_Movie: type: object properties: id: $ref: '#/components/schemas/sdk_shared_v1_MovieID' title: $ref: '#/components/schemas/sdk_shared_v1_LocalizedString' description: $ref: '#/components/schemas/sdk_shared_v1_LocalizedString' genres: type: array items: type: string description: >- Genres associated with this movie (e.g., "Action", "Drama", "Comedy"). durationMs: type: integer format: int32 description: Duration of the movie in milliseconds. cast: type: array items: $ref: '#/components/schemas/sdk_video_v1_CastMember' director: $ref: '#/components/schemas/sdk_shared_v1_LocalizedString' rating: type: string enum: - CONTENT_RATING_UNSPECIFIED - CONTENT_RATING_G - CONTENT_RATING_PG - CONTENT_RATING_PG13 - CONTENT_RATING_R - CONTENT_RATING_NC17 - CONTENT_RATING_TV_Y - CONTENT_RATING_TV_G - CONTENT_RATING_TV_PG - CONTENT_RATING_TV_14 - CONTENT_RATING_TV_MA description: >- ContentRating represents age-based and content-based ratings for video content. Includes both theatrical (MPAA) and television (TV Parental Guidelines) ratings. releaseYear: type: integer format: int32 description: Year the movie was released. artwork: type: array items: $ref: '#/components/schemas/sdk_shared_v1_Image' trailerUrl: type: string description: |- URL to the movie's trailer video. May be empty if no trailer is available. studio: type: string description: Production studio that made this movie. description: Movie represents a standalone film in the video catalog. FieldViolation: type: object properties: field: type: string description: >- The field path that failed validation (e.g., 'user.email' for nested fields). For header validation, this will be the header name (e.g., 'X-API-Key') description: type: string description: >- Human-readable description of the validation violation (e.g., 'must be a valid email address', 'required field missing') required: - field - description description: FieldViolation describes a single validation error for a specific field. sdk_shared_v1_MovieID: type: object properties: value: type: string description: The string value of the movie identifier. required: - value description: MovieID is a typed identifier for a movie. sdk_shared_v1_LocalizedString: type: object properties: value: type: string description: |- The text value resolved for the requested locale. The server selects this based on the Accept-Language header. originalValue: type: string description: |- The text value in its original language. For content originally in Arabic, this is the Arabic text. For content originally in English/Latin, this is the English text. May be identical to value when the requested locale matches the original. description: |- LocalizedString provides a text value in the requested locale along with the original-language value. The resolved value is determined server-side from the Accept-Language request header. Anghami's catalog is Arabic-first, meaning most content has both Arabic and Latin/transliterated titles. This message allows clients to display either representation as needed by the user interface. sdk_video_v1_CastMember: type: object properties: id: $ref: '#/components/schemas/sdk_shared_v1_CastMemberID' name: $ref: '#/components/schemas/sdk_shared_v1_LocalizedString' role: type: string description: Character name or role description (e.g., "Dr. House", "Narrator"). profileImageUrl: type: string description: |- URL to the cast member's profile image. May be empty if no image is available. isLead: type: boolean description: |- Whether this is a lead or main cast member. False for supporting cast and guest appearances. description: |- CastMember represents a person who appears in a show, movie, or episode. Used for both main cast and guest appearances. sdk_shared_v1_Image: type: object properties: url: type: string description: URL of the image. width: type: integer format: int32 description: Width in pixels. height: type: integer format: int32 description: Height in pixels. description: Image represents artwork or visual media at a specific size. sdk_shared_v1_CastMemberID: type: object properties: value: type: string description: The string value of the cast member identifier. required: - value description: CastMemberID is a typed identifier for a cast member. ````