Public API & MCP
Read-only access to your organization metrics, reviews, and subscription events. Authenticate with an organization API key created in Settings → Developer.
Authentication
Send your Nicodesk API key as a Bearer token. Cookie sessions are not accepted on /api/v1.
Authorization: Bearer nd_<prefix>_<secret>
Create and revoke keys in Settings → Developer.
Endpoints
GET https://app.nicodesk.com/api/v1/me
Smoke-test identity: organization id, name, and scopes.
GET https://app.nicodesk.com/api/v1/metrics?range=30D&groupBy=day
Same query params as the dashboard metrics API: range or from/to, groupBy, compare, force.
GET https://app.nicodesk.com/api/v1/reviews?limit=50&platform=ios
Up to 200 most recent reviews. Filters: platform, connectionId, bundleId, unanswered=1, maxRating.
GET https://app.nicodesk.com/api/v1/events?limit=50
Up to 200 most recent subscription events. Filters: platform, connectionId, bundleId.
Example
curl -sS \ -H "Authorization: Bearer nd_YOUR_KEY" \ "https://app.nicodesk.com/api/v1/me"
MCP
The hosted MCP server exposes the same read tools. Pass the API key in the Authorization header.
{
"mcpServers": {
"nicodesk": {
"url": "https://app.nicodesk.com/api/mcp",
"headers": {
"Authorization": "Bearer nd_YOUR_KEY"
}
}
}
}Limits
Soft rate limit: about 120 requests per minute per API key (best-effort on serverless). Reviews and events are capped at 200 rows per request.