POST/api/v1/events/

Search Events

This method is used to fetch details about events, specifically name, location, date and time category and unique identifier

Implementation Notes

This API call returns the basic details of all events available in the EVENTS database. In case the event you search for is not displayed in our database, please send a request to events@aggregateintelligence.in. We will try to make it available within the next 24 hours.

Search Criteria: Any parameter (single or in any combination). For more information about "Category", refer to the Category method under the header "Reference".

Example 1: { "eventId": 0, "eventName": "", "category": "", "country": "", "city": "Barcelona", "state": "", "zip": "" }

Example 2: { "eventId": 0, "eventName": "", "category": "1", "country": "United States", "city": "", "state": "", "zip": "" }

Field Notes: - eventId: Unique ID assigned to an event in the EVENTS database. If the user knows the eventid, they can fetch the basic event details by calls made on this method.

POST/api/v1/events/

Parameter Details

Name	In	Type	Required	Description
`body`	body	`postEventsRequest`	Required	none

Responses

Status	Meaning	Description	Schema
200	OK	OK	`Inline`
400	Bad Request	Bad Request	None
401	Unauthorized	Unauthorized	None
500	Internal Server Error	Internal Server Error	None

Example Request

# You can also use wget
curl -X POST /api/v1/events/ \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

Body parameter

{
  "eventId": 0,
  "eventName": "",
  "category": "0",
  "country": "",
  "city": "",
  "state": "",
  "zip": ""
}

Example responses

200 Response

[
  {
    "eventId": 3455425,
    "eventName": "Hamilton",
    "category": "Entertainment events",
    "subCategory": "Theater",
    "venue": "KeyBank State Theatre",
    "country": "United States",
    "state": "Ohio",
    "city": "Cleveland",
    "zip": "44115",
    "startDate": "2025-10-03 20:00:00"
  }
]

PreviousGet Credits

NextGet Events Info

Need Support?

Our team is here to help you integrate and make the most of our APIs. Get in touch for technical support, custom solutions, or any questions.

Contact Support