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.