Quickstart

curl -X GET "https://api.bavlio.com/api/v1/campaigns/?offset=0&limit=100" \
  -H "Authorization: Bearer bav_live_REPLACE_WITH_YOUR_KEY"

import time
import httpx

def call_with_backoff(client, method, path, *, max_retries=5, **kwargs):
    """Retry on 429 and 5xx with exponential backoff. Stop on 4xx others."""
    for attempt in range(max_retries):
        response = client.request(method, path, **kwargs)
        if response.status_code < 400:
            return response
        if response.status_code == 429:
            retry_after = int(response.headers.get("Retry-After", "1"))
            time.sleep(retry_after)
            continue
        if 500 <= response.status_code < 600:
            time.sleep(2 ** attempt)
            continue
        response.raise_for_status()
    response.raise_for_status()

def drain_all(client, path, *, page_size=100, **params):
    """Drain a list endpoint that uses offset+limit pagination."""
    offset = 0
    while True:
        response = client.get(path, params={**params, "offset": offset, "limit": page_size})
        response.raise_for_status()
        items = response.json()
        if not isinstance(items, list):
            payload = items
            items = payload.get("items", [])
            yield from items
            if not payload.get("has_more"):
                return
        else:
            yield from items
            if len(items) < page_size:
                return
        offset += page_size

# Bavlio API — Quickstart for AI Agents
# Docs: https://bavlio.com/docs/quickstart
# Reference: https://bavlio.com/docs/api-reference/introduction
# OpenAPI: https://api.bavlio.com/openapi.json
#
# Auth: Authorization: Bearer bav_live_...
# Base URL: https://api.bavlio.com
#
# Errors: three envelopes coexist — see /docs/errors for shapes.
# Pagination: endpoint-specific — see /docs/pagination.
# Idempotency-Key header is NOT yet honored — see /docs/errors#idempotency.
# Customer webhooks NOT yet available — poll endpoints listed at /docs/webhooks.
# Rate limits: X-RateLimit-Limit + X-RateLimit-Reset headers; Retry-After on 429.

import os
import httpx

api_key = os.environ["BAVLIO_API_KEY"]
client = httpx.Client(
    base_url="https://api.bavlio.com",
    headers={"Authorization": f"Bearer {api_key}"},
    timeout=30.0,
)

# Identity check
me = client.get("/api/v1/auth/me").raise_for_status().json()
print(f"Authenticated as user_id={me.get('user_id')}")

# List campaigns (offset+limit pagination)
campaigns = client.get("/api/v1/campaigns/", params={"offset": 0, "limit": 100}).json()
print(f"Got {len(campaigns)} campaigns")