Retrieve all teams.

Returns every team the caller has access to.

An optional user_id query parameter filters the result to teams the target user belongs to. Only users reachable by the caller are considered — any user_id outside that scope simply yields an empty list.

GET /teams

Retrieve all teams.

cURL

curl --request GET \
  --url https://incoming.qomon.app/teams \
  --header 'Authorization: Bearer <token>'

200

{
  "status": "success",
  "data": {
    "teams": [
      {
        "id": 101,
        "created_at": "2025-04-23T08:16:26.08912Z",
        "updated_at": "2025-04-30T09:55:59.320084Z",
        "name": "Team Number1",
        "description": "This is a sample team description.",
        "private": false,
        "hide_users": false,
        "leaders": [
          {
            "id": 101,
            "firstname": "John",
            "surname": "Doe",
            "mail": "[e-mail]",
            "avatar": "https://example.com/avatar.png",
            "phone": "0123456789",
            "role": "user",
            "role_data": {
              "id": 5,
              "name": "User",
              "color": "#3b82f6",
              "type": "user",
              "order": 1
            }
          }
        ],
        "users": [
          {
            "id": 101,
            "firstname": "John",
            "surname": "Doe",
            "mail": "[e-mail]",
            "avatar": "https://example.com/avatar.png",
            "phone": "0123456789",
            "role": "user",
            "role_data": {
              "id": 5,
              "name": "User",
              "color": "#3b82f6",
              "type": "user",
              "order": 1
            }
          }
        ],
        "address": {
          "housenumber": "1",
          "street": "rue de la paix",
          "postalcode": "75000",
          "citycode": "75101",
          "city": "Paris",
          "state": "Ile-de-France",
          "country": "France",
          "addition": "Résidence de la paix",
          "infos": "Porte de gauche",
          "building": "Bâtiment A",
          "floor": "2",
          "door": "A",
          "pollingstation": "BV-06",
          "score": 0.75,
          "building_type": "house",
          "lattitude": "89.900000",
          "longitude": "-0.587877",
          "location": "89.900000, -0.587877",
          "invalid": true
        }
      }
    ]
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

user_id · integer<uint>

When set, return only teams the user with this ID belongs to.

Required range: x >= 1

Example:

111

Response

200

application/json

OK

status · string

Example:

"success"

data · object

Show child attributes