Get List of Experiences

Retrieve Available Experiences

get

Fetch a list of available experiences with optional filtering, searching, and sorting parameters.

Query parameters

business_idintegerOptional

Filter experiences by a specific business ID.

searchstringOptional

Search for experiences by keywords in title, description, etc.

category_idstringOptional

Sort by a specific category ID.

sorted_bystring · enumOptional

Sort experiences based on different criteria. Allowed values include:

• just_added: Sort by experiences recently added.
• upcoming: Sort by experiences with future dates.
• randomly: Sort experiences in a random order.

Possible values:

featuredbooleanOptional

Sort by experiences flagged as featured.

Responses

200

Successfully retrieved experiences

application/json

successbooleanOptional

Indicates whether the request was successful.

statusintegerOptional

HTTP status code representing the response status.

messagestringOptional

Human-readable description of the response.

get

/api/v1/merpi/experience

HTTPcURLJavaScriptPython

GET /api/v1/merpi/experience HTTP/1.1
Accept: */*

200

Successfully retrieved experiences

{
  "success": true,
  "status": 200,
  "message": "List of Experiences",
  "data": {
    "experiences": [
      {
        "id": "223f279b-28b2-4b72-8020-cfc2c02b95cb",
        "title": "Easter In Sana Forex",
        "end_date": "2023-01-29T04:41:00Z",
        "description": "...",
        "featured": false,
        "cinema": false,
        "address": {
          "street": "...",
          "town": "...",
          "city": "...",
          "country": "Nigeria"
        },
        "image": [
          {
            "image": "https://syticks.com/….jpg"
          }
        ],
        "business": {
          "id": "764c6a94-7bda-448e-a8af-35a5bb536d4",
          "name": "Party Hard Entertainment",
          "photo": "https://syticks.com/…/PXpF7oIUjV1waH0rLUXFU4ssWg4NYzq1vT6GqHn7.jpg",
          "slug": "party-hard-entertainment",
          "type": "entertainment"
        },
        "category": {
          "id": "5d4ccb2c-09ff-43a4-b96e-a2a035b4226b",
          "slug": "parties",
          "name": "Parties"
        },
        "created_on": "2023-01-28T15:42:11Z"
      },
      {
        "id": "561e3a64-9e9e-47c0-bb6a-87e6ee6e2ead",
        "title": "Avatar the last",
        "end_date": "2024-02-29T00:00:00Z",
        "description": "...",
        "featured": false,
        "cinema": true,
        "cinema_info": {
          "showing": "weekly"
        },
        "address": {
          "street": "...",
          "town": "...",
          "city": "...",
          "country": "Nigeria"
        },
        "image": [
          {
            "image": "https://syticks.com/…/logo.png"
          }
        ],
        "business": {
          "id": "764c6a94-7bda-448e-a8af-35a5bb536d4",
          "name": "Party Hard Entertainment",
          "photo": "https://syticks.com/…/PXpF7oIUjV1waH0rLUXFU4ssWg4NYzq1vT6GqHn7.jpg",
          "slug": "party-hard-entertainment",
          "type": "entertainment"
        },
        "category": {
          "id": "56195f78-a14b-4dc2-b1b8-c3aa62a23f70",
          "slug": "cinema",
          "name": "Cinema"
        },
        "created_on": "2024-02-28T01:16:34Z"
      }
    ],
    "next_page": "2",
    "count": 45,
    "per_page": 20
  }
}

NOTE: Experiences are of two types. Normal experiences that start on a particular date and ends. It could last for just 1 day, or 2 or more. Point is that for normal experiences, it ends and is not recurring. The other kind of experience is the Cinema Experience which is recurring(this means that it repeats over a period of time).

For example, a movie can show on Thursday, Saturday and Sunday every week for the next 4 months or more depending on how long the cinema wants to keep showing it.

The 'cinema' field is what differentiates these experiences. When false, it is a normal experience but if true, it is a cinema experience. So, it is important that you use this field to differentiate them.