✦ For Developers

Programmatic access to your entire partnership data layer

The Alliantra API gives technical teams full access to partner objects, revenue events, reporting endpoints, and real-time webhooks — enabling custom pipelines, warehouse syncs, and bespoke partner workflows.

Core API capabilities

AUTH
Authentication
Bearer token · API keys · OAuth 2.0

All Alliantra API requests are authenticated using Bearer tokens issued from your workspace settings. API keys are scoped per environment (development, staging, production) and can be granted read-only or read-write permissions at the resource level.

For server-to-server integrations, use long-lived API keys stored securely in your environment. For user-facing integrations that access partner data on behalf of a team member, OAuth 2.0 authorization flow is supported with configurable scopes.

Authorization header Bearer {api_key} — required for all requests
X-Workspace-ID header Your workspace identifier — required for multi-workspace accounts
Content-Type header application/json — required for POST and PUT requests
POST
Data Ingestion
/v1/events · /v1/revenue · /v1/partners/import

Push revenue events, partner activity, and attribution data directly into Alliantra from your internal systems. The ingestion API accepts structured JSON payloads representing individual events (conversions, registrations, transactions) or batched records for historical backfills.

Events are validated, normalized, and attributed to the correct partner based on the identifiers provided — then immediately reflected in dashboards and AI models.

partner_id string Alliantra partner identifier to attribute the event to
event_type string conversion | registration | transaction | custom_event
revenue_amount number Revenue value associated with the event in base currency
occurred_at string ISO 8601 timestamp — defaults to request time if omitted
metadata object Optional key-value pairs for custom dimensions and attributes
GET
Partner Objects & Revenue Events
/v1/partners · /v1/partners/{id} · /v1/partners/{id}/events

Retrieve structured partner objects including performance scores, ROI metrics, revenue attribution, and AI-generated signals. Partner objects are the core entity in Alliantra — they aggregate all connected data from your integrated sources and present it through a normalized, queryable model.

Revenue events associated with each partner can be paginated and filtered by period, type, and attribution model to support custom reporting, reconciliation workflows, or warehouse export processes.

period string Date range filter: 7d | 30d | 90d | {start},{end}
status string Filter by partner status: active | at_risk | optimized | inactive
sort string Sort by: roi | revenue | score | growth — default: revenue
include array Optional expansions: ai_signals | forecast | events
GET
Reporting Endpoints
/v1/reports · /v1/reports/roi · /v1/reports/forecast

Access pre-computed report objects that mirror the dashboard views in the Alliantra UI. Reporting endpoints return aggregated performance data for use in downstream BI tools, executive exports, or scheduled data pipeline tasks.

The forecast endpoint returns AI-generated revenue projections by partner, channel, or program — including confidence intervals and scenario outputs for optimistic and conservative assumptions. All report data is refreshed in sync with connected data sources, typically within a 24-hour window.

report_type string roi | channel_breakdown | partner_ranking | forecast
group_by string Dimension to aggregate by: partner | channel | region | month
format string Response format: json | csv — default: json
WH
Webhooks
/v1/webhooks · Event-driven notifications

Subscribe to real-time event notifications from Alliantra delivered to any HTTPS endpoint your system exposes. Webhooks are the primary mechanism for building reactive, event-driven workflows that respond to changes in partner status, performance anomalies, or AI-generated alerts.

partner.status_changed event Fired when a partner's health status transitions (e.g., active → at_risk)
ai.recommendation_created event Fired when the AI engine generates a new budget or allocation recommendation
report.ready event Fired when a scheduled or on-demand report has finished processing
revenue.anomaly_detected event Fired when the AI detects an unexpected deviation in partner revenue patterns
SEC
Security & Access Controls
TLS 1.3 · RBAC · IP allowlisting · Audit logs

All API traffic is encrypted in transit using TLS 1.3. At rest, partner data is encrypted using AES-256. API keys can be scoped to specific resources and operations, and revoked immediately from the workspace settings without affecting other keys.

Enterprise plans include IP allowlisting for API access, audit logs for all API activity, and the ability to configure separate key sets per integration or team. Role-Based Access Control (RBAC) ensures API credentials respect the same permission boundaries as UI access.

What technical teams build with the Alliantra API

The API isn't just for extracting reports. It enables technical teams to embed revenue intelligence into their existing workflows, pipelines, and internal tools.

Data Warehouse Sync

Pull processed partner performance data from Alliantra directly into Snowflake, BigQuery, or Redshift. Schedule nightly syncs using the reporting endpoints to keep your warehouse current without manual exports.

Custom Partner Workflows

Build internal tools that read partner scores and AI recommendations from Alliantra and trigger downstream actions — such as automatically notifying account managers when a partner status changes to at-risk.

Custom Revenue Attribution Pipelines

Use the ingestion API to push revenue events from internal systems that aren't covered by native connectors — including proprietary billing platforms, custom affiliate software, or legacy CRM data.

Advanced Reporting Integrations

Embed Alliantra's processed metrics into Tableau, Power BI, or Looker dashboards by querying the reporting endpoints directly — giving BI teams access to normalized partner data without switching tools.

Client libraries and SDKs

Official SDK support for the most common server-side environments — maintained and updated alongside the API.

Python Node.js Ruby Go Java REST

Get API access and start building

API access is available on Scale and Enterprise plans. Contact our team to request credentials, review API documentation, or discuss a custom integration architecture for your environment.

✓ Available on Scale & Enterprise ✓ Full REST API + Webhooks ✓ SDK support in 5 languages