# Gr4vy Reports API

**Canonical:** https://apis.io/apis/gr4vy/gr4vy-reports-api/  
**Provider:** Gr4vy — https://apis.io/providers/gr4vy/  
**Base URL:** https://api.{id}.gr4vy.app  
**Documentation:** https://docs.gr4vy.com/reference

Gr4vy Reports API is one of 62 APIs that [Gr4vy](https://apis.io/providers/gr4vy/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Reports. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, and rate-limit docs.

In Gr4vy, a report represents the configuration details to extract or dump a set of data into a downloadable CSV file. The data extracted by a report is configured via the reports API where you can specify: * Which fields should be in the dataset. * How the dataset should be sorted. * How the dataset should be filtered. Once a report is created, it may be executed on a one-off or recurring basis. One-off reports are executed only once shortly after the report is created, while recurring reports are executed periodically based on its configured frequency, e.g. weekly or monthly. During a report execution, the data is extracted and loaded into a CSV file according to the report's configuration. The resulting file may then be downloaded. The reports API can be used to: * Create and configure new reports. * List all reports. * View the configuration details of a report. * List a report's executions. * Reconfigure an existing report. * Generate a temporary URL to download the result of a report execution in CSV format.

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| GET | `/report-executions` | List all report executions |
| GET | `/report-executions/{report_execution_id}` | Get report execution |
| POST | `/reports` | New report |
| GET | `/reports` | List reports |
| GET | `/reports/{report_id}` | Get report |
| PUT | `/reports/{report_id}` | Update report |
| GET | `/reports/{report_id}/executions` | List executions for report |
| POST | `/reports/{report_id}/executions/{report_execution_id}/url` | Generate report download URL |

## Machine-readable artifacts (15)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/gr4vy/refs/heads/main/openapi/gr4vy-reports-api-openapi.yml
- **Documentation** — https://docs.gr4vy.com/guides/get-started
- **APIReference** — https://docs.gr4vy.com/reference
- **GettingStarted** — https://docs.gr4vy.com/guides/get-started
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/gr4vy/refs/heads/main/authentication/gr4vy-authentication.yml
- **OAuthScopes** — https://raw.githubusercontent.com/api-evangelist/gr4vy/refs/heads/main/scopes/gr4vy-scopes.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/gr4vy/refs/heads/main/errors/gr4vy-problem-types.yml
- **DeclineCodes** — https://raw.githubusercontent.com/api-evangelist/gr4vy/refs/heads/main/errors/gr4vy-decline-codes.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/gr4vy/refs/heads/main/conventions/gr4vy-conventions.yml
- **Idempotency** — https://raw.githubusercontent.com/api-evangelist/gr4vy/refs/heads/main/conventions/gr4vy-conventions.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/gr4vy/refs/heads/main/data-model/gr4vy-data-model.yml
- **Sandbox** — https://raw.githubusercontent.com/api-evangelist/gr4vy/refs/heads/main/sandbox/gr4vy-sandbox.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/gr4vy/refs/heads/main/rate-limits/gr4vy-rate-limits.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/gr4vy/refs/heads/main/asyncapi/gr4vy-webhooks.yml
- **Postman** — https://github.com/gr4vy/gr4vy-postman

## Other Gr4vy APIs (12)

- [Gr4vy Docs MCP Server](https://apis.io/apis/gr4vy/gr4vy-docs-mcp/)
- [Gr4vy 3DS scenarios API](https://apis.io/apis/gr4vy/gr4vy-3ds-scenarios-api/)
- [Gr4vy Account Updater API](https://apis.io/apis/gr4vy/gr4vy-account-updater-api/)
- [Gr4vy Anti Fraud Service Definitions API](https://apis.io/apis/gr4vy/gr4vy-anti-fraud-service-definitions-api/)
- [Gr4vy Anti-Fraud Services API](https://apis.io/apis/gr4vy/gr4vy-anti-fraud-services-api/)
- [Gr4vy API Key Pairs API](https://apis.io/apis/gr4vy/gr4vy-api-key-pairs-api/)
- [Gr4vy API Logs API](https://apis.io/apis/gr4vy/gr4vy-api-logs-api/)
- [Gr4vy Apple Pay Certificates API](https://apis.io/apis/gr4vy/gr4vy-apple-pay-certificates-api/)
- [Gr4vy Audit Logs API](https://apis.io/apis/gr4vy/gr4vy-audit-logs-api/)
- [Gr4vy Buyers API](https://apis.io/apis/gr4vy/gr4vy-buyers-api/)
- [Gr4vy Buyers - Gift cards API](https://apis.io/apis/gr4vy/gr4vy-buyers-gift-cards-api/)
- [Gr4vy Buyers - Payment methods API](https://apis.io/apis/gr4vy/gr4vy-buyers-payment-methods-api/)

## Tags

Reports

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/gr4vy/gr4vy-reports-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/gr4vy/.