Skip to content
API Reference

REST API Documentation

The CONSETO API allows you to track events, manage consent, and access analytics data programmatically. All endpoints are RESTful and return JSON responses.

Base URL:https://api.conseto.io

Authentication

Authenticate your API requests using your API key. Include it in the Authorization header of every request.

Your API Key
csk_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Find your API key in the dashboard under Settings → API Keys.

bash
curl -X POST https://api.conseto.io/api/consent/events \
 -H "Authorization: Bearer csk_your_api_key" \
 -H "Content-Type: application/json" \
 -d '{
 "clientId": "conseto_xxx_xxx",
 "event": "page_view",
 "properties": {
 "page": "/products"
 }
 }'

Endpoints

POST/api/consentConsent

Record user consent preferences

GET/api/consent/:clientIdConsent

Get consent status for a session

POST/api/consent/eventsEvents

Track custom events

POST/api/consent/pageviewEvents

Track page views

POST/api/consent/conversionsEvents

Track server-side conversions

POST/api/collectEvents

Batch event collection (SDK v2)

GET/api/clients/:id/statsAnalytics

Get analytics statistics

POST/api/audit/singleAudit

Run GDPR compliance audit

Webhooks

Receive real-time notifications when events occur. Configure webhook URLs in your dashboard to get notified about consent changes, conversions, and more.

consent.updated
conversion.created
session.ended
json
{
 "event": "consent.updated",
 "timestamp": "2026-01-25T12:00:00Z",
 "data": {
 "sessionId": "sess_xxx",
 "clientId": "conseto_xxx_xxx",
 "consent": {
 "analytics": true,
 "marketing": false,
 "necessary": true
 }
 }
}

Rate Limits

General API
1,000 req/15min
Auth Endpoints
200 req/15min
Audit Endpoints
30 req/min
AI Endpoints
10 req/hour

SDKs & Libraries

Use our official SDKs for easier integration

JavaScript SDK
2KB gzipped, browser-first
Node.js SDK
Server-side tracking
Python SDK
Django, Flask, FastAPI
PHP SDK
WordPress, Laravel
Developer Ready

Build with CONSETO

Explore our SDKs, dive into the docs, or reach out to our team for integration support.

RESTful JSON API
Zod validation
High availability
Documentation — CONSETO | CONSETO