API Reference — Overview
Base URL
https://api.cdp.internal/v1 # Internal
https://api.cdp.{tenant}/v1 # Tenant-specific
Authentication
All API requests require a Bearer token obtained via OAuth2 client credentials flow. See Authentication.
Rate Limits
| Tier | Requests/min | Burst |
|---|---|---|
| Standard | 1,000 | 2,000 |
| Premium | 10,000 | 20,000 |
| Internal | Unlimited | — |
Response Format
All responses use JSON with standard envelope:
{
"data": { ... },
"meta": {
"request_id": "uuid",
"timestamp": "2026-01-12T10:30:00Z",
"tenant_id": "uuid"
},
"errors": []
}
Available APIs
| API | Base Path | Purpose |
|---|---|---|
| Profile API | /v1/profiles | Read profiles (no browsing) |
| Segment API | /v1/segments | Manage segments |
| Identity API | /v1/identity | Resolve identities |
| Pipeline API | /v1/pipelines | Manage pipelines |
| Consent API | /v1/consent | Manage consent |
| DSAR API | /v1/dsar | Data subject requests |
| MCP Tools | MCP protocol | AI agent access |