WakaTime

About WakaTime

WakaTime provides a REST API for accessing coding activity data such as time spent coding, editors, languages, projects, and operating systems used. The API follows standard REST conventions, returns JSON responses, and requires HTTPS for all requests, with a base URL prefix of https://api.wakatime.com/api/v1/.

Authentication is handled through OAuth 2.0, with dedicated endpoints for authorization, token exchange, and token revocation. Access tokens are passed via a Bearer authorization header or as URL arguments, and refresh tokens allow re-authorization without prompting the user again. Requests are rate-limited to an average of 10 per second over any 5-minute period.

The API supports granular OAuth scopes that let applications request access to specific categories of user data, such as summaries or stats limited to languages, editors, projects, dependencies, machines, or operating systems, rather than requiring blanket access. This is intended for developers building applications or plugins that integrate with a user's WakaTime coding activity data.

Key features

• REST API over HTTPS for coding activity data (heartbeats, stats, summaries)
• OAuth 2.0 authentication with access and refresh tokens
• Granular OAuth scopes for reading specific data types (languages, editors, projects, machines)
• Embeddable SVG charts and JSON for publicly sharing coding stats safely
• Programming language, project, editor, and machine tracking endpoints

Frequently asked questions