---
updatedAt: 2026-10-12T13:25:25.000Z
agentTools:
  projectIndex: https://developers.shoppinggives.com/llms.txt
---

# Get Top Causes

Authorization: Store:Dashboard

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "x-readme": {
    "explorer-enabled": false,
    "proxy-enabled": true,
    "samples-enabled": true
  },
  "info": {
    "title": "Donations Reporting",
    "description": "The Reporting API provides current and historical donations data for a merchant.",
    "version": "v1"
  },
  "servers": [
    {
      "url": "https://reporting.api.shoppinggives.com"
    }
  ],
  "paths": {
    "/top-causes": {
      "get": {
        "tags": [
          "Reporting"
        ],
        "summary": "Get Top Causes",
        "description": "Authorization: Store:Dashboard",
        "parameters": [
          {
            "name": "x-store-id",
            "in": "header",
            "schema": {
              "type": "string",
              "nullable": true,
              "description": "Your store ID (we will provide this).",
              "example": "321944e1-470d-4b0d-a3d8-cf4c96b5b88f"
            }
          },
          {
            "name": "time-zone",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32",
              "description": "Offset from UTC of the time zone you'd like to search for, calculated by UTC - local time (ie: CST would be -6).",
              "example": -6
            }
          },
          {
            "name": "start-date",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time",
              "description": "Top causes created after this date will be returned by the search.",
              "example": "1/1/20"
            }
          },
          {
            "name": "end-date",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time",
              "description": "Top causes created before this date will be returned by the search.",
              "example": "7/1/21"
            }
          },
          {
            "name": "sources",
            "in": "query",
            "schema": {
              "type": "string",
              "nullable": true,
              "description": "List of sources to return top causes for; must be a CSV of valid integer values.",
              "example": "1,2"
            }
          },
          {
            "name": "location-id",
            "in": "query",
            "schema": {
              "type": "string",
              "nullable": true,
              "description": "Top causes associated with this location will be returned by the search.",
              "example": "461a8604-b79d-40f0-b609-f35366f08c20"
            }
          },
          {
            "name": "campaigns",
            "in": "query",
            "schema": {
              "type": "string",
              "nullable": true,
              "description": "List of campaigns IDs to return top causes for; must be in CSV format. \r\n1 = Online Purchase\r\n2 = Yotpo Redemption\r\n3 = Round Ups\r\n4 = Add-on Donations\r\n5 = Point of Sale",
              "example": "1,2"
            }
          },
          {
            "name": "size",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 5,
              "description": "Number of results to return from this search.",
              "example": 5
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success"
          }
        }
      }
    }
  }
}
```