---
title: "Returns the authenticated Scope plan. Default view=compact is plan, remaining, committed burn, this_business, weekly_brief, monday_opportunities, headline_scan_id, and next[]. monday_opportunities is this Pacific week's drop when an agent is connected. Pass view=full for last_spend, upgrade_policy, skip_engines_down, recent_spend, grader_hint, and rate-limit status. Selected-business keys report this_business prompts for the allowed business. business_id is required when the key can access more than one business. next[] names the next read."
method: GET
path: "/whoami"
tags: ["read"]
---

# Returns the authenticated Scope plan. Default view=compact is plan, remaining, committed burn, this_business, weekly_brief, monday_opportunities, headline_scan_id, and next\[\]. monday_opportunities is this Pacific week's drop when an agent is connected. Pass view=full for last_spend, upgrade_policy, skip_engines_down, recent_spend, grader_hint, and rate-limit status. Selected-business keys report this_business prompts for the allowed business. business_id is required when the key can access more than one business. next\[\] names the next read.

`GET /whoami`

## Request

- Base URL: `https://scope.online/v1`
- URL: `https://scope.online/v1/whoami`
- Auth: HTTP bearer

## Query parameters

- `business_id` string, uuid: Optional business to label the weekly brief for
- `view` 'compact' | 'full': compact is the default card; full returns the kitchen-sink payload.

## Response `200`

Tool payload. `meta` holds tldr, next[], pagination cursors, and request_id.

## Other responses

- `400`: Invalid request.
- `401`: Missing or invalid API key.
- `402`: Quota or over-committed.
- `403`: Missing scope or Growth required.
- `404`: Unknown tool or resource.
- `405`: Wrong HTTP method for this tool.
- `429`: Rate limited (10 action calls / 60s per key; reads are higher).
- `503`: Temporary infrastructure limit — retry with retry_after.

---

[API](https://skmtc.dev/scope/apis/scope-api-2.md) · [All operations](https://skmtc.dev/scope/apis/scope-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/scope/apis/scope-api-2/revisions/2f01893f6e5c?raw)