Skip to main content
POST
/
business_event
/
search
Search Business Events
curl --request POST \
  --url https://api-0{X}.moengage.com/v1.0/business_event/search \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "event_ids": [
    "6447b078712cd8c650074840"
  ]
}
'
{
  "data": [
    {
      "db_name": "Sample_App",
      "event_id": "647597767459c85d7d6d6dfd",
      "event_name": "NewMovies",
      "event_attributes": [
        {
          "attribute_name": "MovieName",
          "attribute_data_type": "array"
        },
        {
          "attribute_name": "rating",
          "attribute_data_type": "string"
        }
      ],
      "created_at": "2023-05-29T18:36:52.390000",
      "total_trigger": 0,
      "users_in_segment": 0,
      "usage_count": 0,
      "created_by": "john.doe@moengage.com",
      "last_received_time": "2023-05-30T06:28:06.498000",
      "_id": "64a54500633fda13b6681163"
    }
  ]
}
Rate Limit The rate limit is 100 RPM.

Authorizations

​
Authorization
string
header
required

The Basic authentication header contains your Base64-encoded key. This authentication parameter, used for access control, must be passed with the request.

Format: Authorization: Basic Base64_ENCODED_WORKSPACEID_APIKEY==

Headers

​
Content-Type
string
default:application/json
required

Set the Content-Type header to application/json.

Body

application/json

Search criteria. At least one of event_ids or event_names should be provided.

​
event_ids
string[]

This field contains the list of event ids associated with the business events that need to be fetched.

Structure: "event_ids": ["event_id1","event_id2","event_id3"]

event_id: The event id is the unique identifier for a business event and is generated by MoEngage at the time of business event creation. You must store and use this value while looking up a business event using the search API.

Example:
["6447b078712cd8c650074840"]
​
event_names
string[]

This field contains the list of event names associated with the business events that need to be fetched.

Structure: "event_names": ["event_name1","event_name2","event_name3"]

event_name: The event name is the name associated with the Business Event that is provided during the creation of the event.

Example:
["NewMovies"]

Response

This response is returned when the request is processed successfully.

​
data
object[]