Skip to content
Capturit Backend Docs

Retrieve Group Chats

GET api/message/group/list

This is used to retrieve the list of group chats.

Example Request

Terminal window
curl -X 'GET' \
  'http://localhost:8080/api/message/group/list?page=<page>&page_length=<page_length>' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN'

Parameters

page

Type: Query
Data Type: Integer
Required: Yes
Description: The current page number in the pagination

page_length

Type: Query
Data Type: Integer
Required: Yes
Description: The number of items displayed per page in the pagination

Responses

200 - OK

The request was successful

Content Type: application/json
Content: Group Chats

{
  "current_page": 0,
  "data": [
    {
        "id": 0,
        "event_id": 0,
        "group_chat_name": "string",
        "group_chat_status": 0,
        "group_chat_avatar": "string",
        "latest_message": {
            "id": "string",
            "group_chat_id": "string",
            "message_content": "string",
            "seens": [
            {
                "user": {
                "id": 0,
                "user_first_name": "string",
                "user_middle_name": "string",
                "user_last_name": "string",
                "user_avatar_url": "string"
                }
            }
            ],
            "replied_to": {
            "id": "string",
            "group_chat_id": "string",
            "message_content": "string",
            "user": {
                "id": 0,
                "user_first_name": "string",
                "user_middle_name": "string",
                "user_last_name": "string",
                "user_avatar_url": "string"
            },
            "created_at": "2025-01-22T07:41:04.313Z",
            "updated_at": "2025-01-22T07:41:04.313Z"
            },
            "user": {
            "id": 0,
            "user_first_name": "string",
            "user_middle_name": "string",
            "user_last_name": "string",
            "user_username": "string",
            "user_avatar_url": "string",
            "user_visible": "string"
            },
            "reactions": [
            {
                "id": "string",
                "message_id": "string",
                "message_reaction_count": "string",
                "created_at": "2025-01-22T07:41:04.313Z",
                "updated_at": "2025-01-22T07:41:04.313Z"
            }
            ],
            "attachments": [
            {
                "id": 0,
                "message_attachment_url": "string",
                "message_attachment_added_to_album": true,
                "user": {
                "id": 0,
                "user_first_name": "string",
                "user_middle_name": "string",
                "user_last_name": "string",
                "user_username": "string",
                "user_avatar_url": "string",
                "user_visible": "string"
                },
                "created_at": "2025-01-22T07:41:04.313Z",
                "updated_at": "2025-01-22T07:41:04.313Z"
            }
            ],
            "created_at": "2025-01-22T07:41:04.313Z",
            "updated_at": "2025-01-22T07:41:04.313Z"
        },
    }
  ],
  "first_page_url": "string",
  "from": 0,
  "next_page_url": "string",
  "path": "string",
  "per_page": "string",
  "prev_page_url": "string",
  "to": 0
}

400 - Bad Request

Validation Error

Content Type: application/json
Content:

{
  "param_name": [
    "string"
  ],
  "param_name_2": [
    "string"
  ]
}

401 - Unauthorized

The request requires valid bearer token, but none were provided, or the bearer token is invalid.

429 - Too Many Requests

The user has exceeded the rate limit of 120 requests per minute.

500 - Internal Server Error

There is an issue with the backend. Sentry will provide a more detailed report on the problem.