Search Events

GET

/events/search

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Header Params

Responses

🟢200Success

application/json

Body

🟠400Missing x-omerlo header

🟠401Authorization

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request GET '/events/search?q&category_ids[]=ec9f56fd-6034-4ca2-a4f4-9cbe2be8a46b&profile_type_ids[]=18fe8bf4-3b27-47cc-a692-a20265164868&from=2026-01-09T05:00:00Z&to=2026-02-09T05:00:00Z&timezone=America/Montreal' \
--header 'x-omerlo-media-id: {{omerlo_media_id}}' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "data": [
        {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "profile_type_id": "fcb02d6f-d919-45dd-b606-b0bf8279ebd8",
            "occurrence_id": "8508ee33-23a1-4a06-ae02-1eb167405e7b",
            "type": "regular",
            "name": "string",
            "is_all_day": true,
            "starts_at": "2019-08-24T14:15:22.123Z",
            "ends_at": "2019-08-24T14:15:22.123Z",
            "summary_html": "string",
            "summary_text": "string",
            "canonical_url": "http://example.com",
            "profile_image_url": "../dictionary",
            "cover_image_url": "../dictionary",
            "subscription_url": "../dictionary",
            "meta": {
                "locales": {
                    "current": "string",
                    "available": [
                        "string"
                    ]
                }
            },
            "updated_at": "2019-08-24T14:15:22.123Z"
        }
    ],
    "assocs": {
        "categories": [
            {
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "name": "string",
                "svg_icon": "string",
                "meta": {
                    "locales": {
                        "current": "string",
                        "available": [
                            "string"
                        ]
                    }
                },
                "updated_at": "2019-08-24T14:15:22.123Z"
            }
        ],
        "profile_types": [
            {
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "kind": "event",
                "key": "string",
                "name": "string",
                "meta": {
                    "locales": {
                        "current": "string",
                        "available": [
                            "string"
                        ]
                    }
                },
                "updated_at": "2019-08-24T14:15:22.123Z"
            }
        ]
    },
    "meta": {
        "base": "http://example.com",
        "next": "http://example.com",
        "previous": "http://example.com"
    }
}

Paginated Events

Events dates by range