Skip to main content
GET
Search and list events

Authorizations

X-RP-API-Key
string
header
required

Headers

Accept-Language
string

Supported response locales: ko, en, ja, zh-CN, zh-TW, es, fr, de, pt, th, vi. Default is ko.

Example:

"ko"

Query Parameters

keyword
string

Event name/description keyword

Maximum string length: 100
categories
string[]

Category code. See /v1/codes/event-categories

subjects
string[]

Subject code. See /v1/codes/event-subjects

openTypes
string[]

Open type: OFFLINE / ONLINE / ON_OFFLINE / TBD

startDateFrom
string

Start date >= (YYYY-MM-DD)

startDateTo
string

Start date <= (YYYY-MM-DD)

status
string

Status filter based on event dates. UPCOMING (before start), ONGOING, CLOSED (after end).

page
integer<int32>

Page number to retrieve (starts at 1, default 1)

Required range: x >= 1
pageSize
integer<int32>

Page size (1-50, default 20)

Required range: 1 <= x <= 50

Response

OK

Paginated response. page starts at 1. If page > totalPages, items is an empty array.

totalItems
integer<int64>
required

Total item count

totalPages
integer<int32>
required

Total page count

page
integer<int32>
required

Current page number (starts at 1)

pageSize
integer<int32>
required

Page size

items
object[]
required

Items on the current page