Teams
Get team
Retrieve a team's details, plan, and usage.
GET /teams/{teamId}
Returns full details for a single team, including its plan limits and current usage. Requires at least the viewer role on the team.
Authentication: Bearer token · Role: viewer · Permission:
teams:read · Rate limit: default (120 / 60s)Path parameters
teamId
string · uuid v7 required
The ID of the team to retrieve, from list teams.
Request
curl https://api.twominutereports.com/v1/teams/0190f8b0-1a2b-7c3d-8e4f-5a6b7c8d9e0f \
-H "Authorization: Bearer tmrc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
Returns the full team object.
{
"success": true,
"data": {
"id": "0190f8b0-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
"name": "Acme Marketing",
"createdAt": "2026-01-12T08:15:00.000Z",
"updatedAt": "2026-05-20T11:42:00.000Z",
"plan": {
"name": "Growth",
"status": "active",
"endsOn": null,
"currencyCode": "USD",
"frequency": "month",
"destinations": {
"core": "google_sheets",
"additional": ["looker_studio"]
},
"limits": {
"users": { "base": 5, "addons": 3, "total": 8 },
"accountsPerConnector": { "base": 10, "addons": 5, "total": 15 },
"schedules": {
"total": 100,
"allowedFrequencies": ["Daily", "Weekly", "Monthly"]
}
}
},
"usage": {
"members": { "count": 6, "status": "ok" },
"accountsPerConnector": {
"gadw": { "count": 4, "status": "ok" },
"fb": { "count": 15, "status": "reached" }
},
"schedules": {
"count": 42,
"byFrequency": { "Hourly": 0, "Daily": 30, "Weekly": 10, "Monthly": 2 },
"status": "ok",
"hasRestrictedFrequency": false
}
}
}
}
{
"success": false,
"error": { "code": "BAD_REQUEST", "message": "Invalid UUID: \"abc\"" }
}
Returned when you are not a member of the team, or your role is below viewer.
{
"success": false,
"error": { "code": "FORBIDDEN", "message": "You do not have permission to perform this action" }
}
{
"success": false,
"error": { "code": "NOT_FOUND", "message": "The requested resource was not found" }
}
Fields
id
string · uuid v7
Team identifier.
name
string | null
Display name, or
null if unnamed.createdAt
string
When the team was created.
updatedAt
string | null
When the team was last updated, or
null.plan
object | null
The team's subscription plan, or
null if the team has no plan. Contains name, status (active, in_trial, non_renewing, cancelled), endsOn, currencyCode (USD, INR, EUR), frequency (month, year), destinations, and limits.plan.limits
object
Effective limits.
users and accountsPerConnector each break down into base, addons, and total. schedules has a total cap (nullable) and allowedFrequencies (nullable array).usage
object
Current usage against the plan. Each metric carries a
status of ok, reached, or exceeded. accountsPerConnector is keyed by connector ID. schedules includes a byFrequency breakdown and hasRestrictedFrequency.