API Documentation
Build custom integrations with the Dashtrack REST API. Manage clients, track projects, and access analytics programmatically.
Authentication
All API requests require authentication using an API key. Include your API key in the request header:
Authorization: Bearer your_api_key_here
Generate API keys from your account Settings → API Keys page.
Base URL & Rate Limits
Base URL
https://api.dashtrack.io/v1
Rate Limits
- Starter: 100 requests per hour
- Professional: 1,000 requests per hour
- Agency: 10,000 requests per hour
- Enterprise: Custom limits available
Rate limit headers are included in all responses: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
Endpoints
Clients
GET
/clientsList all clients accessible with your API key
Parameters:
limit(number): Max results (default: 50, max: 500)offset(number): Pagination offset
Projects
GET
/clients/{id}/projectsGet all projects for a specific client
Parameters:
id(string, required): Client IDlimit(number): Max results (default: 50)offset(number): Pagination offsetstatus(string): Filter by status (active, archived, completed)
POST
/clients/{id}/projectsCreate a new project for a client
Request Body:
{
"name": "Q1 Marketing Campaign",
"description": "Social media & email marketing",
"budget": 15000,
"start_date": "2025-01-01",
"end_date": "2025-03-31"
}
Campaign Metrics
GET
/projects/{id}/metricsGet campaign performance metrics for a project
Response:
{
"project_id": "uuid",
"roi": 320,
"leads_generated": 145,
"cost_per_lead": 103.45,
"conversion_rate": 12.3,
"revenue_generated": 45000
}
Team Members
GET
/clients/{id}/teamGet team members assigned to a client
Error Codes
200Success400Bad Request - Invalid parameters401Unauthorized - Invalid or missing API key403Forbidden - No access to this resource404Not Found - Resource does not exist429Too Many Requests - Rate limit exceeded500Internal Server Error