Skip to main content

GET /api/users

Returns a paginated list of all users. 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 users by name or email. Returns all users 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/users?searchTerm=jane&page=1'
{
  "status": true,
  "message": "Usuarios obtenidos correctamente",
  "data": {
    "hasNextPage": false,
    "hasPreviousPage": false,
    "currentPage": 1,
    "pageSize": 8,
    "totalItems": 2,
    "totalPages": 1,
    "items": [
      {
        "id": "user-abc123",
        "roles": ["ORGANIZER"],
        "email": "jane.doe@example.com",
        "firstName": "Jane",
        "lastName": "Doe",
        "location": "New York, USA",
        "isBlocked": false,
        "eventsCount": 5,
        "attendancesCount": 12,
        "reportsCount": 0,
        "ratingsCount": 15,
        "averageRating": 4.7,
        "membership": null,
        "organizedEvents": [],
        "attendances": [],
        "comments": [],
        "madeReports": [],
        "reports": [],
        "madeRatings": [],
        "ratings": []
      }
    ]
  }
}

Build docs developers (and LLMs) love