Skip to main content

​
Authentication

All API requests require authentication. The API supports multiple authentication methods.

​
Authentication Methods

​
Bearer Token

Include a bearer token in the Authorization header: 
curl -X GET https://api.betterdata.co/api/products \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Organization-Id: org_123"

​
API Key

Include an API key in the X-API-Key header: 
curl -X GET https://api.betterdata.co/api/products \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-Organization-Id: org_123"
For browser-based requests, include session cookies: 
fetch('/api/products', {
  credentials: 'include'
})

​
Organization Context

All API requests must include organization context:
  • Header: X-Organization-Id: org_123
  • Session: Organization ID in authenticated session
  • Token: Organization ID embedded in token
Scope: Tenant-scoped; requires authenticated org context
Availability: Not available in SuperAdmin

​
Getting Credentials

Contact your organization administrator to obtain:
  • API tokens
  • API keys
  • Access credentials

​
Permissions & Roles

API authentication requires valid credentials with organization access. Token permissions determine which endpoints are accessible.