> For the complete documentation index, see [llms.txt](https://syticks.gitbook.io/merpi-by-syticks/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://syticks.gitbook.io/merpi-by-syticks/api-reference/cinema-ticketing-cinema-movies-available-days-purchase-etc/get-cinema-businesses.md).

# Get Cinema Businesses

Returns all businesses on Syticks that operate as cinema operators.

**GET** `/api/v1/merpi/business?business_type=entertainment&cinema=true`

This endpoint fetches a list of cinema businesses on Syticks. Cinema businesses are a subset of entertainment businesses on the platform, so you need to pass both `business_type=entertainment` and `cinema=true` to scope results correctly. Omitting either parameter will return a broader set of results than intended.

***

### Query Parameters

**`business_type`** `string · required for this context`

Must be set to `"entertainment"`. Cinema businesses live under the entertainment type on Syticks.

Possible values: `entertainment`

***

**`cinema`** `string · required for this context`

Must be set to `"true"` to return only cinema businesses.

Possible values: `true`

***

### Example Request

**Fetch all cinema businesses**

```
GET /api/v1/merpi/business?business_type=entertainment&cinema=true HTTP/1.1
Accept: application/json
```

***

### Example Response

```json
{
  "success": true,
  "status": 200,
  "message": "List of Businesses",
  "data": {
    "business": [
      {
        "id": "d4e5f6a7-0000-4000-8000-444444444444",
        "name": "Silverscreen Cinemas",
        "photo": "https://syticks.com/storage/profilePhotos/sample2.jpg",
        "slug": "silverscreen-cinemas",
        "type": "entertainment",
        "cinema": true
      },
      {
        "id": "e5f6a7b8-0000-4000-8000-555555555555",
        "name": "Reel House",
        "photo": "https://syticks.com/storage/profilePhotos/sample4.jpg",
        "slug": "reel-house",
        "type": "entertainment",
        "cinema": true
      },
      {
        "id": "f6a7b8c9-0000-4000-8000-666666666666",
        "name": "Grandview Pictures",
        "photo": null,
        "slug": "grandview-pictures",
        "type": "entertainment",
        "cinema": true
      }
    ],
    "next_page": null,
    "count": 3,
    "per_page": 20
  }
}
```

***

#### Response Fields

| Field                    | Type            | Description                                                                       |
| ------------------------ | --------------- | --------------------------------------------------------------------------------- |
| `success`                | boolean         | Whether the request was successful.                                               |
| `status`                 | integer         | HTTP status code.                                                                 |
| `message`                | string          | A short description of the response.                                              |
| `data.business`          | array           | List of cinema business objects.                                                  |
| `data.business[].id`     | string (UUID)   | Unique identifier for the business.                                               |
| `data.business[].name`   | string          | Display name of the business.                                                     |
| `data.business[].photo`  | string or null  | URL to the business profile photo, or null if not set.                            |
| `data.business[].slug`   | string or null  | URL-friendly identifier for the business, or null if not set.                     |
| `data.business[].type`   | string          | Always `"entertainment"` for cinema businesses.                                   |
| `data.business[].cinema` | boolean         | Always `true` on this endpoint since results are scoped to cinema operators only. |
| `data.next_page`         | integer or null | Page number of the next page of results, or null if there are no more pages.      |
| `data.count`             | integer         | Total number of businesses returned in this response.                             |
| `data.per_page`          | integer         | Maximum number of results per page.                                               |
