API Reference

The Two Minute Reports API is a REST API that lets you manage your account, teams, connections, and clients, and run data queries programmatically — the same capabilities available in the app, exposed over HTTP with JSON.

Base URL

https://api.twominutereports.com/v1

All paths in this reference are relative to this base URL. For example, GET /users/me means GET https://api.twominutereports.com/v1/users/me.

Authentication

Every request must include a bearer token in the Authorization header:

curl https://api.twominutereports.com/v1/users/me \
  -H "Authorization: Bearer tmrc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Create and manage keys from your account settings. See Authentication for full details.

Response format

Every response uses a consistent envelope so you can branch on a single success flag.

{
  "success": true,
  "data": { }
}

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "The requested resource was not found"
  }
}

Conventions

• Content type: Request bodies are JSON (Content-Type: application/json), except file uploads which use multipart/form-data.
• IDs: Resource IDs such as teamId, userId, and sessionId are UUID v7 strings. Account IDs are provider-defined strings prefixed with the connector ID (e.g. gadw_1234567890).
• Timestamps: All timestamps are ISO 8601 strings in UTC (e.g. 2026-06-16T09:30:00.000Z).
• Roles: Team-scoped endpoints require a minimum role — viewer, editor, or owner. Each endpoint notes its requirement.

Reference