API Overview

The Metric API allows you to programmatically access your organization’s data and build custom automations. You can query projects, employees, time logs, invoices, and more — or retrieve dashboard metrics, charts, and reports to integrate with your own tools and workflows.

Available API Endpoints

APIDescription
GraphQL APIQuery and explore all your organization’s data
Dashboard DataRetrieve card, chart, and table data from dashboards

Authentication

All endpoints use an API access token issued by the Metric support team. Contact support to obtain your token.

Include the token in the Authorization header on every request:

Authorization: Bearer <your_access_token>

The token inherits the permissions of the user it is associated with, so the data you can access depends on your role and permissions within the organization.

Rate Limits

Standard rate limits apply to all API endpoints. If you receive a 429 status code, wait before retrying your request.

Error Handling

The API returns standard HTTP status codes:

  • 200 — Success
  • 400 — Bad request (missing or invalid parameters)
  • 401 — Unauthorized (invalid or missing token)
  • 429 — Too many requests
  • 500 — Internal server error

Error responses include a text message describing the issue.

IntegrationsGraphQL API