API Documentation

Design.Build.Data provides a REST API for programmatic access to your analytics data.

Authentication

All API requests require a valid API key passed in the Authorization header. You can generate and manage keys from your dashboard settings.

Authorization: Bearer ddb_sk_xxxxxxxxxxxxxxxxxxxx

Rate Limits

Free tier: 60 requests per minute. Professional tier: 600 requests per minute. Enterprise tier: Custom limits. Rate limit headers are included on every response.

Endpoints

MethodPathDescription
GET/api/v1/projectsList all projects
GET/api/v1/queriesList saved queries
POST/api/v1/query/runExecute a SQL query
GET/api/v1/dashboardsList dashboards
GET/api/v1/usersList team members

Example Request

curl -H "Authorization: Bearer ddb_sk_xxx" \
     https://api.designbuilddata.com/api/v1/projects

Example Response

{
  "projects": [
    {
      "id": 1,
      "name": "Q4 Revenue Analysis",
      "owner": "sarah.chen@acme.com",
      "dashboards": 4,
      "created": "2026-01-05"
    }
  ],
  "total": 1
}