> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bossmode.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# Reports API

> Access Daily Reports, historical report data, and configure report delivery via the Reports API.

<Warning>🚧 Expanding soon — full Reports API documentation is in progress.</Warning>

## Get today's report

```bash theme={null}
curl -sH "x-bossmode-token: $BOSSMODE_API_TOKEN" \
  https://bossmode.ing/api/pro/reports/daily | jq
```

## Get report for a specific date

```bash theme={null}
curl -sH "x-bossmode-token: $BOSSMODE_API_TOKEN" \
  "https://bossmode.ing/api/pro/reports/daily?date=2026-04-12" | jq
```

Date format: `YYYY-MM-DD` in your configured timezone.

## List report history

```bash theme={null}
curl -sH "x-bossmode-token: $BOSSMODE_API_TOKEN" \
  "https://bossmode.ing/api/pro/reports?limit=30&offset=0" | jq
```

## Report response shape

```json theme={null}
{
  "reportId": "rpt_abc123",
  "date": "2026-04-12",
  "generatedAt": "2026-04-13T07:00:00Z",
  "sections": {
    "revenue": {
      "total": 1247,
      "currency": "USD",
      "events": [...]
    },
    "agentActivity": {
      "directivesExecuted": 4,
      "movesApproved": 3,
      "movesBlocked": 1,
      "capos": { ... }
    },
    "approvalQueue": {
      "pending": 2,
      "urgent": 0,
      "items": [...]
    },
    "trustIntelligence": {
      "scoresCompleted": 7,
      "averageScore": 58,
      "topGap": "Specificity"
    },
    "guardianState": {
      "mode": "guardrailed",
      "pendingMoves": 2,
      "blockedMoves": 0
    }
  }
}
```

## Report formats

Request a specific format via the `Accept` header:

```bash theme={null}
# JSON (default)
curl -sH "x-bossmode-token: $BOSSMODE_API_TOKEN" \
  -H "Accept: application/json" \
  https://bossmode.ing/api/pro/reports/daily

# Plain text / Markdown
curl -sH "x-bossmode-token: $BOSSMODE_API_TOKEN" \
  -H "Accept: text/plain" \
  https://bossmode.ing/api/pro/reports/daily
```

## Configure report delivery

See [Report Customization](/daily-report/customization) for configuration options.

## Webhooks

Subscribe to receive reports automatically:

```bash theme={null}
curl -sX POST https://bossmode.ing/api/pro/webhooks \
  -H "x-bossmode-token: $BOSSMODE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "event": "report.daily",
    "url": "https://your-server.com/hooks/bossmode-report",
    "secret": "your_webhook_secret"
  }'
```
