---
name: "EngagementPayouts Api v1"
last_updated: 2026-06-11T23:12:12Z
type: legacy
api_base_url: "https://engagementpayouts.roblox.com"
versions: [v1]
endpoints: 1
auth: [cookie]
---

# EngagementPayouts Api v1

> **Warning:** Legacy APIs with cookie authentication can incorporate breaking changes without notice. We don't recommend them for production applications.

**Base URL:** `https://engagementpayouts.roblox.com`
**Versions:** v1

## Endpoints

### GET `/v1/universe-payout-history`

Gets the engagement payout history for a specific universe and a given date range, specified by start and end dates.

**Parameters:**

| Name | In | Type | Required | Description |
|------|-----|------|----------|-------------|
| `universeId` | query | `integer (int64)` | Yes | The ID of the universe in question. |
| `startDate` | query | `string` | Yes | The first date in the range, specified as yyyy-MM-dd. |
| `endDate` | query | `string` | Yes | The last date in the range, specified as yyyy-MM-dd. |

**Responses:**

- `200`: OK → `object`
- `400`: 1: InvalidUniverseId
 2: InvalidStartDate
 3: InvalidEndDate
 4: InvalidDateRange
 5: Forbidden
 6: TooManyDays
- `401`: 0: Authorization has been denied for this request.

**Error handling:** `401`: Check that your API key/token is valid and not expired. 

**Example:**
```bash
curl -H "Authorization: Bearer $ROBLOX_ACCESS_TOKEN" \
  "https://engagementpayouts.roblox.com/v1/universe-payout-history?universeId={VALUE}&startDate={VALUE}&endDate={VALUE}"
```

## Models

### Roblox.EngagementPayouts.Api.PayoutResponseModel

A model for payout responses

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `engagementScore` | `number` | No | Gets the engagement score |
| `payoutInRobux` | `integer` | No | Gets the payout in Robux |
| `payoutType` | `string` | No | Gets the payout type |
| `eligibilityType` | `string` | No | Gets the eligibility type |