Introducing Macroscope API: two hands cradling a glowing orb beside the line "Bring Macroscope data wherever you work."
Macroscope
Macroscope
Product

Introducing the Macroscope API

All your Macroscope data, available to your scripts, pipelines and coding agents.

Your Macroscope data now has an API. Pull it into a dashboard, a weekly report script, or a data pipeline. Or hand it to a coding agent and let it pull whatever context it needs.

It's read-only for now.

What you can use it for

  • Productivity statistics: contributor and team stats, sprint reports and coding time trends
  • Billing data: what's driving your spend
  • Code review performance: bugs detected, bugs addressed, and thumbs up/down feedback from developers
  • Approvability: every PR the agent approved or sent to a human, the reasoning behind each verdict, and approval rates over time
  • Check run agents: how your custom agents are performing
  • Executive summaries: what your team shipped and where the effort went

Get a key

Workspace admins create a key under Settings → API. Send it as a bearer token with each request:

GET/api/v1/workspaces/{workspaceType}/{workspaceId}
curl https://api.macroscope.com/api/v1/workspaces/GITHUB_ORGANIZATION/$MACROSCOPE_WORKSPACE_ID \
  -H "Authorization: Bearer $MACROSCOPE_API_KEY"

Set MACROSCOPE_WORKSPACE_ID to your GitHub organization's numeric ID. You can find it with gh api orgs/YOUR_ORG --jq .id.

The API docs cover keys, authentication and every endpoint. Send questions or requests for new endpoints to support@macroscope.com.

Try the Macroscope API
Bring usage data, code-review results, Approvability metrics and engineering stats into your own tools and agents.