REST API

Northbeams exposes a read API so you can pull your data into a spreadsheet, a BI tool, or another system.

What you need

• A workspace on the Sentinel tier or higher (API access is a Sentinel entitlement).
• An API token. Create one under Settings, then API access. It looks like nbm_... and is shown once, so copy it somewhere safe.

Calling it

• Base URL: https://monitor.northbeams.com/api/v1
• Auth: send Authorization: Bearer nbm_... on every request. The token scopes to your workspace, so it can only ever read your own org's data.
• Rate limit: 30 requests per 60 seconds, per token.

curl -s https://monitor.northbeams.com/api/v1/inventory \
  -H "Authorization: Bearer nbm_your_token_here"

Prefer natural language?

The same data is available to an AI assistant through the MCP connector, so you can ask "what shadow AI showed up this month?" instead of writing a query.