Reconcile OEM Tenant Usage - FullHunt API Documentation

OEM query_tags provide customer-defined attribution fields. Use stable identifiers such as tenant_id, workspace_id, and request_id on every credited request, then reconcile those tags against account audit logs.

Tag every OEM request

{
  "type": "domain",
  "query": "your-customer-domain.example",
  "query_tags": {
    "tenant_id": "tenant-123",
    "workspace_id": "workspace-456",
    "request_id": "request-789"
  }
}

Do not place customer names, API keys, passwords, or other secrets in tags.

Generate a usage summary

export FULLHUNT_API_KEY="YOUR_API_KEY"
export FULLHUNT_USAGE_START="2026-08-01"
export FULLHUNT_USAGE_END="2026-08-31"
python reconcile_oem_usage.py

reconcile_oem_usage.py

import collections
import json
import os

import requests

BASE_URL = "https://fullhunt.io/api/v1/oem/account"
HEADERS = {"X-API-KEY": os.environ["FULLHUNT_API_KEY"]}
START = os.environ["FULLHUNT_USAGE_START"]
END = os.environ["FULLHUNT_USAGE_END"]


def post(path, body):
    response = requests.post(
        f"{BASE_URL}{path}",
        headers=HEADERS,
        json=body,
        timeout=30,
    )
    response.raise_for_status()
    return response.json()["response"]


credits = post("/credits", {"query_tags": {"workflow": "usage-reconciliation"}})
counts = collections.Counter()
page = 1

while True:
    result = post(
        "/audit-logs",
        {"page": page, "start_date": START, "end_date": END},
    )
    for entry in result.get("logs", []):
        tags = entry.get("query_tag") or {}
        tenant = tags.get("tenant_id", "unattributed")
        service = entry.get("service", "unknown")
        operation = entry.get("name", "unknown")
        counts[(tenant, service, operation)] += 1

    if not result.get("pagination", {}).get("has_next"):
        break
    page += 1

summary = [
    {
        "tenant_id": tenant,
        "service": service,
        "operation": operation,
        "requests": count,
    }
    for (tenant, service, operation), count in sorted(counts.items())
]

print(json.dumps({"credits": credits, "usage": summary}, indent=2))

Reconciliation notes

Account credit and audit-log operations do not deduct OEM credits.
Audit logs are returned 50 records per page.
Date filters use YYYY-MM-DD.
The audit-log request is recorded after its own result set is calculated, so a subsequent request can observe a slightly larger total.
Request counts are not automatically billing units. Apply your own pricing and failure policy outside FullHunt.

Track unattributed requests as an integration defect. A production system should reject credited OEM requests that do not include the required tenant tags.