> 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/general-endpoints-get-all-businesses-transaction-requery-etc/get-businesses-endpoints.md).

# Get Businesses Endpoints

### **GET** `/api/v1/merpi/business`

This endpoint fetches a list of businesses on Syticks. They can be filtered by passing a query parameter of `business_type` with values `"entertainment"`, `"bus"`, or `"hospitality"`. If `"entertainment"` is passed, it returns all entertainment businesses on Syticks. If `"bus"` is passed, it returns all transport companies. If `"hospitality"` is passed, it returns all hospitality businesses.

***

### Query Parameters

**`business_type`** `string · enum`

Filters businesses by type. Valid values are `"entertainment"`, `"bus"`, and `"hospitality"`.

Possible values: `entertainment` `bus` `hospitality`

***

**`cinema`** `string · enum · optional`

Filters entertainment businesses by whether they operate as a cinema. This parameter is only valid when `business_type=entertainment` is also present in the request. Passing it with any other business type will return a validation error.

* `cinema=true` returns only cinema businesses
* `cinema=false` returns only non-cinema entertainment businesses
* Omitting it returns all entertainment businesses regardless of cinema status

Possible values: `true` `false`

***

### Understanding the `cinema` Parameter

Entertainment businesses on Syticks cover two distinct kinds of operators: regular event organisers who sell tickets to concerts, shows, and experiences, and cinema operators who manage movie screenings and seat bookings. Both live under the `entertainment` type, but they behave differently downstream and expose different booking flows.

The `cinema` field on each entertainment business object tells you which category a business falls into. The `cinema` query parameter lets you filter at the request level, so you only get back the businesses relevant to what you are building. If you are integrating a cinema booking flow, pass `cinema=true` and you will only receive cinema operators. If you are building around general events and experiences, pass `cinema=false` to exclude cinemas entirely. If you need everything under entertainment, leave the parameter out.

***

### Example Requests

**Fetch only cinema businesses**

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

**Fetch only non-cinema entertainment businesses**

```
GET /api/v1/merpi/business?business_type=entertainment&cinema=false HTTP/1.1
Accept: */*
```

**Fetch all businesses (no filter)**

```
GET /api/v1/merpi/business HTTP/1.1
Accept: */*
```

***

#### Example Response

The example below shows a mixed response with both entertainment and transport businesses. Notice that `cinema` appears on entertainment business objects and is absent on transport and hospitality ones.

```json
{
  "success": true,
  "status": 200,
  "message": "List of Businesses",
  "data": {
    "business": [
      {
        "id": "0384a1ce-9933-4452-966e-9a0d09d17015",
        "name": "Your Fav Ticket Vendor",
        "photo": "https://syticks.com/storage/profilePhotos/qr3JZSnp...jpg",
        "slug": "your-fav-ticket-vendor",
        "type": "entertainment",
        "cinema": false
      },
      {
        "id": "764c6a94-7bda-448e-a8af-35a5bb536d4",
        "name": "Party Hard Entertainment",
        "photo": "https://dev.syticks.com/storage/profilePhotos/PXpF7oIU...jpg",
        "slug": "party-hard-entertainment",
        "type": "entertainment",
        "cinema": true
      },
      {
        "id": "26838f1e-b6c2-43e7-9dd4-3409512fff64",
        "name": "Good Ride",
        "photo": "https://dev.syticks.com/storage/profilePhotos/hdwLJbfh...jpg",
        "slug": "good-ride",
        "type": "transport"
      },
      {
        "id": "abd5b9d4-f98f-483c-b0a4-eaadcdc776fa",
        "name": "Stay-IN",
        "photo": null,
        "slug": "stay-in",
        "type": "hospitality"
      }
    ],
    "next_page": null,
    "count": 4,
    "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 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          | The business category. One of `entertainment`, `transport`, or `hospitality`.                            |
| `data.business[].cinema` | boolean         | Whether the business is a cinema operator. Only present on businesses where `type` is `"entertainment"`. |
| `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.                                                                      |