---
updatedAt: 2026-08-25T19:26:55.000Z
agentTools:
  projectIndex: https://docs.hivestack.com/llms.txt
---

# Get a list of report definitions

Returns a list of report definitions associated to your organization

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "x-explorer-enabled": false,
  "info": {
    "title": "Reports",
    "version": "2",
    "description": "Reports"
  },
  "tags": [
    {
      "name": "Report Definitions",
      "description": ""
    }
  ],
  "security": [
    {
      "APIKeyHeader": []
    },
    {
      "APIKeyQuery": []
    }
  ],
  "paths": {
    "/reportdefinitions": {
      "get": {
        "tags": [
          "Report Definitions"
        ],
        "summary": "Get a list of report definitions",
        "description": "Returns a list of report definitions associated to your organization",
        "operationId": "getReportDefinitions",
        "responses": {
          "200": {
            "description": "OK - List of objects representing report definitions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/reportdefinitions"
                },
                "examples": {
                  "response": {
                    "value": "[\n  {\n      \"definition_json\": {\n          \"breakdown\": \"CUMULATIVE\",\n          \"format\": \"csv\",\n          \"dates\": {\n              \"mode\": \"ABSOLUTE\",\n              \"start_date\": \"2019-09-13\",\n              \"end_date\": \"2019-09-21\"\n          },\n          \"dimensions\": [],\n          \"metrics\": [\n              \"IMPRESSIONS\",\n              \"SPEND\"\n          ],\n          \"filters\": []\n      },\n      \"last_executed_on_utc\": \"2019-09-20T20:01:12\",\n      \"name\": \"My report\",\n      \"organization_id\": 1,\n      \"report_definition_id\": 1\n  },\n]"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://apps.hivestack.com/api/v2"
    }
  ],
  "components": {
    "securitySchemes": {
      "APIKeyHeader": {
        "name": "hs-auth",
        "type": "apiKey",
        "in": "header"
      },
      "APIKeyQuery": {
        "name": "apikey",
        "type": "apiKey",
        "in": "query"
      }
    },
    "schemas": {
      "reportdefinition": {
        "type": "object",
        "properties": {
          "definition_json": {
            "type": "object",
            "properties": {
              "breakdown": {
                "type": "string"
              },
              "format": {
                "type": "string"
              },
              "dates": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "string"
                  },
                  "start_date": {
                    "type": "string",
                    "format": "date"
                  },
                  "end_date": {
                    "type": "string",
                    "format": "date"
                  }
                }
              },
              "dimensions": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "metrics": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "filters": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "property": {
                      "type": "string"
                    },
                    "values": {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      }
                    }
                  }
                }
              }
            }
          },
          "last_executed_on_utc": {
            "type": "string",
            "format": "date-time"
          },
          "name": {
            "type": "string"
          },
          "organization_id": {
            "type": "integer"
          },
          "report_definition_id": {
            "type": "integer"
          }
        },
        "example": {
          "definition_json": {
            "breakdown": "CUMULATIVE",
            "format": "csv",
            "dates": {
              "mode": "ABSOLUTE",
              "start_date": "2019-09-13",
              "end_date": "2019-09-21"
            },
            "dimensions": [],
            "metrics": [
              "IMPRESSIONS",
              "SPEND"
            ],
            "filters": []
          },
          "last_executed_on_utc": "2019-09-20T20:01:12",
          "name": "My report",
          "organization_id": 1,
          "report_definition_id": 1
        }
      },
      "reportdefinitions": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/reportdefinition"
        }
      }
    }
  }
}
```