> For the complete documentation index, see [llms.txt](https://docs.cookie3.com/cookie3-analytics/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cookie3.com/cookie3-analytics/api/referral-systems/accessing-leaderboard-and-user-data.md).

# Accessing leaderboard and user data

To retrieve the Leaderboard metrics, make a `POST` request to:

```url
https://wa.api.gateway.cookie3.co/acquisition/getGroupedMetrics
```

#### Sample Request Body

{% hint style="info" %}
To find out your Conversion Event's ID head over to [this article](/cookie3-analytics/features/conversion-events/retrieving-your-conversion-event-unique-id.md).
{% endhint %}

```json
{
  "filter": {
    "dateFrom": "2024-10-01T00:00:00.000Z",
    "dateTo": "2024-10-31T23:59:59.999Z",
    "sites": ["<YOUR_SITE_ID>"]
  },
  "primaryGroupingDimension": "CustomReferrer",
  "goalIds": ["yourConversionEventId"]
}
```

### Parameters Explained

* **Filter:**
  * `dateFrom` and `dateTo`: Specify the time frame in ISO datetime format
  * `sites`: An array of siteIds
* **Primary grouping dimension:** Groups data by primary dimension (e.g., **CustomReferrer**)
* **goalIds:** An array of your Conversion Event IDs

## Retrieving Data for a Particular User

{% hint style="info" %}
To find out your Conversion Event's ID head over to [this article](/cookie3-analytics/features/conversion-events/retrieving-your-conversion-event-unique-id.md).
{% endhint %}

To retrieve data for a specific user, add the `customFilters` object to your request body:

```json
{
  "filter": {
    "dateFrom": "2024-10-01T00:00:00.000Z",
    "dateTo": "2024-10-31T23:59:59.999Z",
    "sites": ["<YOUR_SITE_ID>"]
  },
  "customFilters": {
    "equalFilterCustomReferrer": [
      "cookie-monster"
    ]
  },
  "primaryGroupingDimension": "CustomReferrer",
  "goalIds": ["yourConversionEventId"]
}
```