---
title: "List Configs"
method: GET
path: "/v2/report-configs"
tags: ["report-configs"]
---

# List Configs

`GET /v2/report-configs`

## Request

- Base URL: `https://api.stuut.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stuut.ai/v2/report-configs`
- Auth: HTTP bearer

List Report Configs

List report configurations for the organization.
Optionally filter by report type.

## Query parameters

- `report_type` 'integration_sync_report' | 'ar_aging_report' | 'invoice_report' | 'customer_report' | 'payments_report' | 'credit_memo_report'

## Response `200`

Successful Response

- ReportConfig[]
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, nullable, required
  - `id` string, required
  - `report_type` 'integration_sync_report' | 'ar_aging_report' | 'invoice_report' | 'customer_report' | 'payments_report' | 'credit_memo_report', required
  - `is_enabled` boolean, required
  - `frequency` 'daily' | 'weekly' | 'monthly', required
  - `format` 'csv' | 'xlsx', required
  - `time` string, time, required: Time of day (HH:MM) in org timezone. Minutes must be 0 or 30.
  - `weekday` integer, required: Day of the week (0=Monday, 6=Sunday). Only used by WEEKLY frequency.
  - `recipient_emails` string[], required: Primary recipient email addresses
  - `cc_emails` string[], nullable, required: Optional CC email addresses (e.g., FDE team on failures)
  - `notify_on_issues_only` boolean, required: If true, suppress the routine success email and only send when the sync had a failure or an expected entity synced zero records in the window. Only applies to INTEGRATION_SYNC_REPORT.
  - `last_sent_at` string, date-time, nullable, required: UTC timestamp of the last successful report send
  - `object` string, required: String representing the object's type. Objects of the same type share the same value.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/stuut/apis/stuut-api.md) - [All operations](https://skmtc.dev/stuut/apis/stuut-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stuut/apis/stuut-api/revisions/ff0ad16a55ff?raw)
