Skip to main content

GET /api/events

Returns a paginated list of all events. This endpoint is publicly accessible and does not require authentication.
Results are paginated with a page size of 8 items. Use the page parameter to navigate between pages.

Query parameters

searchTerm
string
Filter events by title or description. Returns all events when omitted.
page
number
default:"1"
Page number to retrieve. Starts at 1.

Response fields

status
boolean
required
Indicates whether the request succeeded.
message
string
Human-readable result message.
data
object
required
curl --request GET \
  --url 'https://api.meetpoint.com/api/events?searchTerm=music&page=1'
{
  "status": true,
  "message": "Eventos obtenidos correctamente",
  "data": {
    "hasNextPage": true,
    "hasPreviousPage": false,
    "currentPage": 1,
    "pageSize": 8,
    "totalItems": 24,
    "totalPages": 3,
    "items": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "categoryId": "c1d2e3f4-0000-1111-2222-333344445555",
        "categoryName": "Music",
        "organizerId": "user-abc123",
        "organizerName": "Jane Doe",
        "organizerRating": 4.7,
        "organizerRatingsCount": 15,
        "title": "Summer Music Festival",
        "description": "An outdoor music festival featuring local artists.",
        "ubication": "Central Park, New York",
        "date": "2026-07-20T18:00:00Z",
        "publicationDate": "2026-03-01T10:00:00Z",
        "attendancesCount": 120,
        "commentsCount": 34,
        "attendances": [],
        "comments": []
      }
    ]
  }
}

Build docs developers (and LLMs) love