Skip to content

Get the platform console overview

The platform.overview.get operation: GET /api/v1/platform/overview in the REST API and the platform_overview_get tool in the MCP server.

GET/api/v1/platform/overview

The platform console's home (spec §39.1): organizations by status, legal entities waiting for document review, support-access requests waiting for an organization's decision and grants active now, open AUP reports, and the system's dead jobs and undispatched outbox rows (system.status: critical with dead jobs, warning with a backlog). Counts only.

At a glance

  • REST: GET /api/v1/platform/overview
  • MCP tool: platform_overview_get
  • Operation ID: platform.overview.get
  • Scope: Platform
  • Permission: platform:read
  • Risk tier: read
  • Dry run: Not supported
  • Idempotency: Not needed (read only)
  • Modes: Test and live
  • Authentication: API key with the platform:read scope
  • Since: M12

Request

Query parameters

This operation takes no query parameters.

Response

200 OK with a JSON object:

FieldTypeDescription
object"platform_overview"
atdate-time
organizationsobject
organizations.totalinteger
organizations.byStatusobject
verificationsPendinginteger
supportRequestsWaitinginteger
supportGrantsActiveinteger
openAupReportsinteger
systemobject
system.statusone of ok, warning, critical
system.deadJobsinteger
system.outboxPendinginteger

Examples

A quiet morning

HTTP
GET /api/v1/platform/overview
Authorization: Bearer or_test_…

Response (200):

JSON
{
  "object": "platform_overview",
  "at": "2026-11-03T09:00:00.000Z",
  "organizations": {
    "total": 214,
    "byStatus": {
      "active": 209,
      "restricted": 3,
      "suspended": 1,
      "closing": 1
    }
  },
  "verificationsPending": 2,
  "supportRequestsWaiting": 1,
  "supportGrantsActive": 1,
  "openAupReports": 0,
  "system": {
    "status": "ok",
    "deadJobs": 0,
    "outboxPending": 0
  }
}

Errors

CodeHTTP statusWhenWhat to do
permission_denied403You aren't platform staff with read access to the platform console.Ask an organization owner or admin for a role or scope that allows this action.

It can also return these common errors: validation_failed, api_version_unsupported, authentication_required, api_key_invalid, resource_not_found, dry_run_not_supported, rate_limited, internal_error.