List groups

Production

https://api-v2.getmarvia.com

GET

/v1/groups

Required Permission: read:groups

This endpoint requires an API key with the read:groups permission. Make sure your token was created with this permission during token creation.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Query Params

Header Params

Responses

🟢200OK

application/json

Success

Body

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api-v2.getmarvia.com/v1/groups?limit&page&sortBy&sortOrder' \
--header 'Authorization: <api-key>'

Response Example

200 - Example 1

{
    "_tag": "Success",
    "data": [
        {
            "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
            "name": "string"
        }
    ],
    "pagination": {
        "limit": 1,
        "page": 1,
        "total": 0,
        "pageCount": 0
    }
}

Modified at 2025-09-08 06:20:01

Delete a group

Create a new group