This page is about using the CodeRabbit API to generate on-demand reports about your organization's usage of CodeRabbit. For a conceptual overview of reports in CodeRabbit, see[Generate reports](/guides/reports-overview).

If you're new to CodeRabbit's reporting features, then we recommend starting with[Scheduled reports](/guides/scheduled-reports) to understand the available options and capabilities.

If you're new to CodeRabbit's reporting features, then we recommend starting with[Scheduled reports](/guides/scheduled-reports) to understand the available options and capabilities. In almost every scenario we recommend using the**Scheduled Reports** option. The**On-demand Report** does not have any additional benifits from the**Scheduled Reports** and has many limitations.

There are two ways to generate reports:

-**[Scheduled Reports](/guides/scheduled-reports)**: Set up automated, recurring reports that are delivered to your team on a set schedule. Supported delivery channels include the following:

-**[Scheduled Reports](/guides/scheduled-reports)**: Set up automated, recurring reports that are delivered to your team on a set schedule.**Use this option if you want to adjust your settings and send a report more than once**.Supported delivery channels include the following:

- Email

- Discord

- Slack

- Teams

-**[On-demand Reports](/guides/ondemand-reports)**: If yourequire customized integration of reports with your own tools and workflows, then youcan generate reports programmatically through our API.

-**[On-demand Reports](/guides/ondemand-reports)**: If youwant to test a report format and produce a single report once, try the "On-demand Reports" Option. Youcanalsogenerate reports programmatically through our API, but we do not recommend this as the API reporting is in beta. If you want to run an**On-demand Report** more than once then you must use the**Scheduled Reports** option.

For your first reports, we recommendexploring scheduled reports. Its web-based UI can help you get familiar withtheoptions available to you.

In almost every scenario we recommendusing the**Scheduled Reports** option. The**On-demand Report** does not have any additional benifits fromthe**Scheduled Reports** and has many limitations.