Skip to main content

​
Endpoints

MethodPathAuth Required
GET/api/categoriesNone (public)
GET/api/categories/{id}None (public)
POST/api/categoriesADMIN or ORGANIZER
PUT/api/categories/{id}ADMIN or ORGANIZER
DELETE/api/categories/{id}ADMIN or ORGANIZER

​
GET /api/categories

Returns a paginated list of all categories. Supports optional search filtering. Auth: None required.

​
Query Parameters

​
searchTerm
string
Optional search string to filter categories by name or description. Defaults to an empty string (returns all).
​
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 category objects.

​
Example

curl -X GET "https://api.meetpoint.com/api/categories?searchTerm=music&page=1"

​
GET /api/categories/

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

​
Path Parameters

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

​
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
object
The category object.

​
Example

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

​
POST /api/categories

Creates a new category. Auth: Bearer token required. Roles: ADMIN or ORGANIZER.
This endpoint requires the ADMIN or ORGANIZER role. Requests from users without these roles will receive a 403 Forbidden response.

​
Request Body

​
name
string
required
The name of the category. Cannot be empty.
​
description
string
An optional description for the category. Must be at least 10 characters if provided.

​
Response Fields

​
data
object
The newly created category object.

​
Example

curl -X POST "https://api.meetpoint.com/api/categories" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Music",
    "description": "Events related to music and concerts"
  }'

​
PUT /api/categories/

Updates an existing category. Auth: Bearer token required. Roles: ADMIN or ORGANIZER.
This endpoint requires the ADMIN or ORGANIZER role.

​
Path Parameters

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

​
Request Body

​
name
string
required
The updated name of the category.
​
description
string
The updated description. Must be at least 10 characters if provided.

​
Response Fields

​
data
object
The updated category object.

​
Example

curl -X PUT "https://api.meetpoint.com/api/categories/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Live Music",
    "description": "Events featuring live music performances"
  }'

​
DELETE /api/categories/

Deletes a category by its UUID. Auth: Bearer token required. Roles: ADMIN or ORGANIZER.
This endpoint requires the ADMIN or ORGANIZER role. Deleted categories cannot be recovered.

​
Path Parameters

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

​
Response Fields

​
data
object
The deleted category object.

​
Example

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

Build docs developers (and LLMs) love

Get started for freeTalk to us