Integration Logs

What can you do?

View your integrations — get the list of all ETL integrations configured for your company.
Check the activity history — see how many times an integration ran and when.
Analyze results — view the summary of successes and failures per phase over a date range.
Explore records — search and browse the data processed by a specific run.

Before you start

You need:

A client_id and a client_secret — generated by a Fracttal administrator from the Permission Groups section.
Your account must have the Automator → Fracttal Hub module enabled.

If you're missing either of these, contact your account administrator before continuing.

Quick start

1. Get your access token

curl -X POST "https://one.fracttal.com/oauth/token" \
  -H "Authorization: Basic $(echo -n 'YOUR_CLIENT_ID:YOUR_CLIENT_SECRET' | base64)" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials"

Save the access_token value — you'll need it for the next steps. It's valid for 2 hours.

2. List your integrations

curl -X GET "https://one.fracttal.com/hub/api/v1/dags" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

You'll get the list of your integrations along with their dag_id. Use that identifier for the following endpoints.

3. Query the records of a run

curl -X GET "https://one.fracttal.com/hub/api/v1/dags/YOUR_DAG_ID/runs/2026-06-05/YOUR_RUN_ID/phases/load/data" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Section	Description
How to authenticate	How to get and use your access token
List ETL integrations	View all your integrations
Run summary	Success/failure statistics per phase
Activity history	Activity grouped by day, week, or month
View processed records	Explore the data of a specific run

Base URL

All endpoints start from:

https://one.fracttal.com/hub

# 1. Obtain an access token
TOKEN=$(curl -s -X POST https://one.fracttal.com/oauth/token \
  -H "Authorization: Basic $(echo -n 'CLIENT_ID:CLIENT_SECRET' | base64)" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" | jq -r .access_token)

# 2. List available DAGs
curl -s https://one.fracttal.com/hub/api/v1/dags \
  -H "Authorization: Bearer $TOKEN" | jq .

# 3. Inspect a specific run
DAG_ID="589b6c65-1ce9-4a46-9c11-ad380d9bf27a"
curl -s "https://one.fracttal.com/hub/api/v1/dags/$DAG_ID/runs/2026-06-05/manual_20260605T140709_c003" \
  -H "Authorization: Bearer $TOKEN" | jq .

# 4. Browse load-phase rows
curl -s "https://one.fracttal.com/hub/api/v1/dags/$DAG_ID/runs/2026-06-05/manual_20260605T140709_c003/phases/load/data?page=0&limit=50" \
  -H "Authorization: Bearer $TOKEN" | jq