List teams

GET/teams

users:read EnterpriseSince v2

Your organisation's teams, each with the members on it (those who hold a seat). A team with a territory is the one projects drawn inside that area can be assigned to. A member's teams are also in their teamIds, and a project's in its teamIds.

Request

curl 'https://api.measuremaponline.com/api/v2/teams' \
  -H "Authorization: $MMO_API_KEY"

Response

[
  {
    "type": "team",
    "id": "north",
    "name": "North crew",
    "color": "#16a34a",
    "description": "Jobs north of the river",
    "memberIds": [
      "m3K8qZxLpV4NrT2w",
      "s8Pq1Lz4"
    ],
    "createdOn": 1788000000000,
    "territory": {
      "minLat": 51.5,
      "minLng": -0.2,
      "maxLat": 51.6,
      "maxLng": 0
    }
  },
  {
    "type": "team",
    "id": "south",
    "name": "South crew",
    "color": "#2563eb",
    "description": "",
    "memberIds": [
      "s8Pq1Lz4"
    ]
  }
]

Responses

A list ofTeam:
- typestringrequired
  Always"team"
- idstringrequired
- namestringrequired
- colorstring
  Hex colour, as the app shows the team.
- descriptionstring
- memberIdsarray of stringrequired
  The members on the team who hold a seat.
- createdOninteger(int64)
- territoryobject
  The area the team covers. Projects drawn inside it can be assigned to the team.

Errors

A failed request answers with one of these, in an Error body.

403insufficient_scopeThe key does not have the access this endpoint needs. Create a key with that access.

403invalid_api_keyNo key was sent in the Authorization header, or the key is unknown, revoked, or past the time it kept working after being replaced.

403scope_not_in_planYour plan does not include this endpoint, for example members on Open Guest.

403subscription_expiredYour subscription is not active. Update your payment method in the app.

Try it

API key

This key is

The key stays in this tab and goes only to the API. Use a sandbox key while you try things: requests are real, and what they change is changed.

GET https://api.measuremaponline.com/api/v2/teams

Fill in your API key to send.

As a cURL command

Shell

curl 'https://api.measuremaponline.com/api/v2/teams' \
  -H "Authorization: $MMO_API_KEY"