Skip to documentation
Organization & teamAnalytics

Analytics

Methods, permissions, request fields and response schemas for analytics.

Read and search

Retrieve current records, history and status.

Read the organization overviewRead the same current analytics snapshot used by the organization dashboard.GET/analytics/overview
Token scope analytics:readActor permission managerAction type read
Explore this request

Edit example fields and validate the request against its schema.

What you receive

Current organization analytics overview from the same service as the dashboard. Snapshot figures are not an invented historical time series.

Request example · cURL

Replace example IDs and values. Supply the token from your secret store. Each intended write uses one stable $ACTION_KEY.

curl -X GET "$BASE/analytics/overview" \
  -H "Authorization: Bearer $ALLPROFILES_API_TOKEN"
Success response schema · HTTP 200
{
  "application/json": {
    "schema": {
      "type": "object",
      "properties": {
        "counts": {
          "type": "object",
          "properties": {
            "profiles": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "rented": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "available": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "unlisted": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "verified": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "rentedPct": {
              "type": "number"
            },
            "availablePct": {
              "type": "number"
            },
            "unlistedPct": {
              "type": "number"
            },
            "verifiedPct": {
              "type": "number"
            }
          },
          "required": [
            "profiles",
            "rented",
            "available",
            "unlisted",
            "verified",
            "rentedPct",
            "availablePct",
            "unlistedPct",
            "verifiedPct"
          ],
          "additionalProperties": true
        },
        "mrrCents": {
          "type": "integer"
        },
        "netCents": {
          "type": "integer"
        },
        "growthPct": {
          "type": "number"
        },
        "mrrSeries": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "minLength": 0,
                "maxLength": 5000
              },
              "key": {
                "type": "string",
                "minLength": 0,
                "maxLength": 5000
              },
              "value": {
                "type": "number"
              }
            },
            "required": [
              "label",
              "key",
              "value"
            ],
            "additionalProperties": true
          }
        },
        "netSeries": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "minLength": 0,
                "maxLength": 5000
              },
              "key": {
                "type": "string",
                "minLength": 0,
                "maxLength": 5000
              },
              "value": {
                "type": "number"
              }
            },
            "required": [
              "label",
              "key",
              "value"
            ],
            "additionalProperties": true
          }
        },
        "topCustomers": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "uuid"
              },
              "name": {
                "type": "string",
                "minLength": 0,
                "maxLength": 5000
              },
              "email": {
                "type": [
                  "string",
                  "null"
                ],
                "minLength": 0,
                "maxLength": 5000
              },
              "avatarUrl": {
                "type": [
                  "string",
                  "null"
                ],
                "minLength": 0,
                "maxLength": 5000
              },
              "accounts": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "monthlySpendCents": {
                "type": "integer"
              },
              "totalSpentCents": {
                "type": "integer"
              }
            },
            "required": [
              "id",
              "name",
              "email",
              "avatarUrl",
              "accounts",
              "monthlySpendCents",
              "totalSpentCents"
            ],
            "additionalProperties": true
          }
        },
        "accounts": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "format": "uuid"
              },
              "displayName": {
                "type": "string",
                "minLength": 0,
                "maxLength": 5000
              },
              "photoUrl": {
                "type": [
                  "string",
                  "null"
                ],
                "minLength": 0,
                "maxLength": 5000
              },
              "status": {
                "type": "string",
                "minLength": 0,
                "maxLength": 5000
              },
              "monthsRented": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "earningsCents": {
                "type": "integer"
              },
              "netCents": {
                "type": "integer"
              },
              "marginPct": {
                "type": "number"
              },
              "costLines": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "minLength": 0,
                      "maxLength": 5000
                    },
                    "amountCents": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991
                    }
                  },
                  "required": [
                    "label",
                    "amountCents"
                  ],
                  "additionalProperties": true
                }
              },
              "costTotalCents": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              }
            },
            "required": [
              "id",
              "displayName",
              "photoUrl",
              "status",
              "monthsRented",
              "earningsCents",
              "netCents",
              "marginPct",
              "costLines",
              "costTotalCents"
            ],
            "additionalProperties": true
          }
        }
      },
      "required": [
        "counts",
        "mrrCents",
        "netCents",
        "growthPct",
        "mrrSeries",
        "netSeries",
        "topCustomers",
        "accounts"
      ],
      "additionalProperties": true
    }
  }
}
Errors and recovery
400
Invalid JSON, request fields, query, path identifier or missing Idempotency-Key.
401
Missing, invalid, revoked or expired organization API token; its issuing actor must still be the current organization owner.
403
Token scope or actor capability denied, disabled/banned account, or action unavailable.
404
Unknown route or resource not accessible in the bound organization. Cross-tenant resources are not enumerated.
409
Conflicting profile/rental state, duplicate resource, idempotency payload mismatch or operation still in progress.
410
event_cursor_expired: the event cursor is behind retained history. Reconcile current resources and start from the supplied recovery cursor.
422
Business validation/moderation rejected the operation. CHAT_MESSAGE_BLOCKED was not delivered.
429
API rate/concurrency limit exceeded; use backoff and Retry-After when present.
500
Internal operation error. Sensitive implementation details are not returned. Investigate using the request ID before repeating a write.
503
Provider or configuration unavailable; uncertain writes must retain the same Idempotency-Key.

These are documented API errors. The local sandbox checks schema fields only and does not test authorization, moderation or provider behavior.

Financial fields named ...Cents or ...InCents use integer cents. Path fields and nested constraints are shown above and in the downloadable OpenAPI contract.