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: application/json' \
  --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

Authentication is done via Basic Auth. This requires a base64-encoded string of your credentials in the format 'username:password'.

  • Username: Use your MoEngage workspace ID (also known as the App ID). You can find it in the MoEngage dashboard at Settings > Account > APIs > Workspace ID (earlier app id).
  • Password: Use your API Key, which you can find within the Campaign report/Business events/Custom templates/Catalog API/Inform Report tile.

For more information on authentication and getting your credentials, refer here.

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[]