Daily Data Export API

The Daily Data Export API returns presigned download URLs for an AI Employee's Agent QA daily export and its manifest file. The export is generated nightly by Ema's internal workflow and covers all calls processed on the specified UTC date.

Use this API to pull evaluation results, scorecards, and insights into your own data warehouse, BI tool, or downstream analytics system.

14.1 Authentication & Headers

14.2 Get Daily Export Data

Query Parameters

Example Request

curl -X GET \
  "{base_url}/api/agent-qa/get_daily_data?persona_id=<persona_id>&date=2025-06-01" \
  -H "Authorization: Bearer <token>"

Response

A successful response (200 OK) returns a JSON object with the following fields:

14.3 File Structure

The two presigned URLs point to files stored in Ema's internal cloud storage. One is a data file containing the actual records and results. The other is a manifest file describing the export partition. URLs expire within an hour; re-request if needed.

Data File (signed_url → agent_qa_export.jsonl)

The data file is JSONL (newline-delimited JSON). Each line is a self-contained JSON object representing one processed call record, corresponding to a single resource_id. The schema is defined by AgentQACallRecord.

Insight Attributes

Rule Result Attributes

Feedback Attributes

Each object in a rule result's feedbacks list represents either a user thumbs-up/down rating or a reviewer decision. The feedback_type field distinguishes between the two kinds.

Late Reviews

A reviewer decision made after a call's original export date is called a late review. When one or more late reviews exist on a call, the call re-appears in the next nightly export with updated scores and decision data. The late_review_count field on the call record indicates how many late reviewer decisions it carries. This is separate from late_feedback_count, which covers late user ratings.

Manifest File (manifest_signed_url → manifest.json)

The manifest file is a single JSON object describing the export partition. It is written alongside the data file after the nightly export completes successfully. The schema is defined by AgentQAExportManifest.

14.4 Error Codes

14.5 Rate Limits

A rate limit of 1 query per second is enforced on this API.

14.6 Sample Python

The snippet below downloads and parses agent_qa_export.jsonl from the presigned URL returned by the API.

import json
import urllib.request

# Step 1 — call the API to get the presigned URLs
req = urllib.request.Request(
    "https://api.<region>.ema.co/api/agent-qa/get_daily_data"
    "?persona_id=<persona_id>&date=2025-06-01",
    headers={
        "Authorization": "Bearer <token>",
        "x-persona-id": "<persona_id>",
    },
)
with urllib.request.urlopen(req) as resp:
    urls = json.load(resp)

signed_url = urls["signed_url"]
manifest_signed_url = urls["manifest_signed_url"]

# Step 2 — download and parse the JSONL data file
records = []
with urllib.request.urlopen(signed_url) as resp:
    for line in resp:
        line = line.strip()
        if line:
            records.append(json.loads(line))

# Step 3 — work with the records
for record in records:
    resource_id      = record["resource_id"]
    agent_id         = record["agent_id"]
    final_score      = record.get("final_score")
    sentiment        = record.get("sentiment")
    resolution       = record.get("resolution_status")
    agent_mapping_id = record.get("agent_mapping_id")
    rule_results     = record["rule_results"]
    insights         = record["insights"]

    print(f"{resource_id} | agent={agent_id} | score={final_score} | {sentiment} | {resolution}")

    for rule in rule_results:
        print(f"  [{rule['result']}] {rule['rule_name']} (weight={rule['rule_weight']})")
        for feedback in rule.get("feedbacks", []):
            fb_type = feedback.get("feedback_type")
            if fb_type == "LOW_CONFIDENCE_FEEDBACK":
                print(f"    [REVIEW] {feedback.get('feedback_user_email')} — {feedback.get('decision')}")
            else:
                print(f"    [FEEDBACK] {'👍' if feedback.get('is_positive') else '👎'} {feedback.get('feedback_user_email')}")

    for insight in insights:
        print(f"  [{insight['insight_type']}] {insight['driver']} — {insight['category']}")

# Step 4 — download and parse the manifest
with urllib.request.urlopen(manifest_signed_url) as resp:
    manifest = json.load(resp)

print(f"Export date : {manifest['date']}")
print(f"Window      : {manifest['window_start']} → {manifest['window_end']}")
print(f"Row count   : {manifest['row_count']}")

14.7 On-Demand Current-Day Export

The nightly export (above) always covers a past, completed UTC day. To pull data from the current calendar day before the next nightly run, request the live export from the Audit tab's export action. It is delivered asynchronously rather than as a direct download, since a busy day's export can take up to a minute to build:

1. Requesting the export starts a background build and returns a request ID immediately.
2. The UI polls status until the build completes.
3. Once complete, a signed download URL is provided, valid for 1 hour.