Skip to main content
The Oleander API allows you to ingest, retrieve, and query lineage events programmatically. All endpoints require authentication via a Bearer token.

​
Base URL

https://oleander.dev

​
Authentication

All API requests require a Bearer token in the Authorization header. 
curl -H "Authorization: Bearer YOUR_API_KEY" https://oleander.dev/api/v1/events
You can generate an API key from your oleander dashboard.

​
Endpoints

Record Lineage Event

POST /api/v1/lineage — Submit an OpenLineage compliant event.

List Events

GET /api/v1/events — Retrieve lineage events with filtering and pagination.

Query the Lake

POST /api/v1/warehouse/query — Execute SQL queries against the oleander lake. Pro plan only.

​
OpenLineage

Oleander implements the OpenLineage specification for lineage event ingestion. Any OpenLineage-compatible client or integration can send events directly to the /api/v1/lineage endpoint.

OpenLineage Specification

View the OpenLineage OpenAPI specification