Skip to main content

​
Endpoints

MethodPathAuth Required
GET/api/ratingsADMIN only
GET/api/ratings/{id}None (public)
GET/api/ratings/user/{userId}USER, ADMIN, or ORGANIZER
POST/api/ratingsUSER, ADMIN, or ORGANIZER
PUT/api/ratings/{id}USER, ADMIN, or ORGANIZER
DELETE/api/ratings/{id}USER, ADMIN, or ORGANIZER

​
GET /api/ratings

Returns a paginated list of all ratings on the platform. Auth: Bearer token required. Role: ADMIN only.
This endpoint is restricted to the ADMIN role. All other authenticated users will receive 403 Forbidden.

​
Query Parameters

​
searchTerm
string
Optional search string to filter ratings. Defaults to an empty string.
​
page
integer
Page number for pagination. Defaults to 1.

​
Response Fields

​
status
boolean
Indicates whether the request was successful.
​
statusCode
integer
HTTP status code of the response.
​
message
string
Human-readable message describing the result.
​
data
array
List of rating objects.

​
Example

curl -X GET "https://api.meetpoint.com/api/ratings?page=1" \
  -H "Authorization: Bearer <admin-token>"

​
GET /api/ratings/

Returns a single rating by its UUID. Auth: None required.

​
Path Parameters

​
id
string (UUID)
required
The unique identifier of the rating.

​
Response Fields

​
data
object
The rating object.

​
Example

curl -X GET "https://api.meetpoint.com/api/ratings/3fa85f64-5717-4562-b3fc-2c963f66afa6"

​
GET /api/ratings/user/

Returns the average rating score for a specific user (organizer). Auth: Bearer token required. Roles: USER, ADMIN, or ORGANIZER.

​
Path Parameters

​
userId
string
required
The ID of the user (organizer) whose average rating to retrieve.

​
Response Fields

​
data
decimal
The average rating score for the specified user.

​
Example

curl -X GET "https://api.meetpoint.com/api/ratings/user/user-id-string" \
  -H "Authorization: Bearer <token>"

​
POST /api/ratings

Submits a new rating for an event and its organizer. Auth: Bearer token required. Roles: USER, ADMIN, or ORGANIZER.

​
Request Body

​
raterId
string
The ID of the user submitting the rating. Typically resolved from the authenticated token.
​
eventId
string (UUID)
required
The ID of the event being rated.
​
organizerId
string
required
The ID of the event organizer being rated.
​
score
decimal
required
The rating score. Must be between 0 and 5 (inclusive).

​
Response Fields

​
data
object
The newly created rating object.

​
Example

curl -X POST "https://api.meetpoint.com/api/ratings" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "raterId": "user-id-string",
    "eventId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "organizerId": "organizer-id-string",
    "score": 4.5
  }'

​
PUT /api/ratings/

Updates the score of an existing rating. Auth: Bearer token required. Roles: USER, ADMIN, or ORGANIZER.

​
Path Parameters

​
id
string (UUID)
required
The unique identifier of the rating to update.

​
Request Body

​
score
decimal
required
The updated rating score. Must be between 0 and 5 (inclusive).

​
Response Fields

​
data
object
The updated rating object.

​
Example

curl -X PUT "https://api.meetpoint.com/api/ratings/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "score": 3.0
  }'

​
DELETE /api/ratings/

Deletes a rating. Auth: Bearer token required. Roles: USER, ADMIN, or ORGANIZER.

​
Path Parameters

​
id
string (UUID)
required
The unique identifier of the rating to delete.

​
Response Fields

​
data
object
The deleted rating object.

​
Example

curl -X DELETE "https://api.meetpoint.com/api/ratings/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "Authorization: Bearer <token>"

Build docs developers (and LLMs) love

Get started for freeTalk to us