Skip to main content

Endpoints

MethodPathAuth Required
GET/api/reportsADMIN only
GET/api/reports/{id}USER, ADMIN, or ORGANIZER
POST/api/reportsUSER, ADMIN, or ORGANIZER
PUT/api/reports/{id}USER, ADMIN, or ORGANIZER
DELETE/api/reports/{id}USER, ADMIN, or ORGANIZER

GET /api/reports

Returns a paginated list of all reports 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 reports. 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 report objects.

Example

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

GET /api/reports/

Returns a single report by its UUID. Auth: Bearer token required. Roles: USER, ADMIN, or ORGANIZER.

Path Parameters

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

Response Fields

data
object
The report object.

Example

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

POST /api/reports

Files a new report against an organizer. Auth: Bearer token required. Roles: USER, ADMIN, or ORGANIZER.

Request Body

reporterId
string
The ID of the user filing the report. Typically resolved from the authenticated token.
organizerId
string
required
The ID of the organizer being reported.
reason
string
required
The reason for the report. Must be at least 10 characters.

Response Fields

data
object
The newly created report object.

Example

curl -X POST "https://api.meetpoint.com/api/reports" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "reporterId": "user-id-string",
    "organizerId": "organizer-id-string",
    "reason": "This organizer repeatedly posts misleading event information."
  }'

PUT /api/reports/

Updates the reason for an existing report. Auth: Bearer token required. Roles: USER, ADMIN, or ORGANIZER.

Path Parameters

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

Request Body

reason
string
required
The updated reason for the report. Must be at least 10 characters.

Response Fields

data
object
The updated report object.

Example

curl -X PUT "https://api.meetpoint.com/api/reports/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "Organizer cancelled the event without any notice or refund."
  }'

DELETE /api/reports/

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

Path Parameters

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

Response Fields

data
object
The deleted report object.

Example

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

Build docs developers (and LLMs) love