fastmon Docs
Organizations

Get Organization

Report an issue

Get organization by ID, including what the caller may do in it.

Loads the org itself rather than taking OrgDep: pairing that loader with an access alias would run OrgAccessChecker twice (two dependency objects, two identical membership SELECTs).

Authorization

bearerAuth
headerAuthorizationBearer <token>

API token generated from the fastmon dashboard (Account → API Token) or at organization level (fmo_…, one that outlives its creator). Send as Authorization: Bearer fm_... or paste the full token (including its prefix) into the Authorize dialog.

Path Parameters

org_id*Org Id
Formatuuid

Response Body

Successful Response

application/json
  1. response
id*Id

Identifier of the organization.

Formatuuid
name*Name

Display name.

is_active*Is Active

Whether the organization is enabled.

review_status*ReviewStatus

Where the organization stands in the anti-abuse review. Applications and sites, and with them ingestion, wait for approval.

Value in"pending""approved""blocked"
intended_domain?Intended Domain

The domain the organization said it wants to monitor, from sign-up.

storage*Storage

Which ClickHouse storage tier holds this organization's beacons.

Value in"shared""dedicated""external"
clickhouse_table*Clickhouse Table

The table its beacons are read from.

plan*Plan

Subscription plan.

Value in"none""free""one""partner""enterprise"
is_partner*Is Partner

Whether this organization manages client organizations as an agency.

ai_enabled*Ai Enabled

Whether AI features are switched on for it.

synthetic_enabled*Synthetic Enabled

Whether synthetic monitoring is switched on for it.

mcp_enabled*Mcp Enabled

Whether the MCP server is switched on for it.

features?array<>

Every catalog feature with what makes it available to this organization. A locked one is shown with its upsell, not hidden.

Default[]
role?Role

The caller's role here.

Value in"owner""member""viewer"
permissions?array<string>

What that role currently means for the caller. Gate a UI on this rather than on the role, so a re-cut role bundle needs no client change.

Default[]
access?Access

How the caller reaches this organization: through a membership, through a partner link, or through the platform-admin bypass.

Value in"member""partner""admin"
GET
/organizations/{org_id}
curl -X GET 'https://api.fastmon.eu/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "name": "string",  "is_active": true,  "review_status": "pending",  "intended_domain": "string",  "storage": "shared",  "clickhouse_table": "string",  "plan": "none",  "is_partner": true,  "ai_enabled": true,  "synthetic_enabled": true,  "mcp_enabled": true,  "features": [],  "role": "owner",  "permissions": [],  "access": "member"}