Authenticate API requests - Metricanic

Use an API key to connect server applications and scheduled jobs to your workspace.

Issue a key for the application

In the tracker, open API keys and create a key with a recognizable label. Choose read for reports or write to also create, update, archive, and restore entities. Copy the token when it is issued. For subscription requirements, expiry, and rotation, see Manage API keys.

Send the token in a header

Store the token in an environment variable or your application’s secret store. Send it as a Bearer token:

curl 'https://panel.metricanic.com/api/v1/whoami' \
  -H "Authorization: Bearer $METRICANIC_API_KEY"

For a key labeled daily-report-export, a successful response has this shape:

{
	"ok": true,
	"data": {
		"tenantId": "YOUR_WORKSPACE_ID",
		"provider": "api-key",
		"scope": "read",
		"keyId": "YOUR_KEY_ID",
		"label": "daily-report-export"
	}
}

Check that tenantId and scope match the workspace and access your application needs. Then follow the API quickstart to make your first report query. For a failed request, see API errors. Keep the token out of query strings, browser scripts, and application logs. To connect an AI assistant, use the MCP connection.