> ## Documentation Index
> Fetch the complete documentation index at: https://growi.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get payouts 24h

> Retrieves payout data with comparison to previous period

> [!WARNING]
>
> **Deprecated.** This is one of the old Home stats endpoints. It still works, but new
> integrations should use the faster endpoints. Use [Payout totals](https://growi.mintlify.site/api-reference/endpoint/payouts/payout-totals.md) (`GET /payouts/totals`).
> Responses carry `Deprecation` and `Link` headers.
> It takes `MM/DD/YYYY` dates; the new endpoints take ISO 8601 (`YYYY-MM-DD`). See [deprecations](https://growi.mintlify.site/api-reference/changelog.md#deprecations).

Retrieves payout data with comparison to previous period.

## Request parameters

| Parameter | Type | Description | Required |
| - | - | - | - |
| `start_date` | String | Start date in MM/DD/YYYY format | Yes |
| `end_date` | String | End date in MM/DD/YYYY format | Yes |
| `limit` | Integer | Limit the number of results. Default is 4. Recommended is 20. Set to 10,000 to get all data. | No |

## Request example

```bash theme={"dark"}
curl -X GET "https://api.growi.io/api/public/v1/stats/payouts_24h?start_date=01/01/2023&end_date=01/31/2023" \
     -H "Authorization: Bearer YOUR_PUBLIC_API_KEY" \
     -H "Content-Type: application/json"
```

## Response example

```json theme={"dark"}
{
  "success": true,
  "data": {
    "current_period": {
      "date_range": "2023-01-30 to 2023-01-31",
      "total_payouts": 28450.75,
      "currency": "USD",
      "payout_count": 42,
      "avg_payout": 677.40,
      "unique_creators_paid": 37,
      "total_content_rewarded": 156,
      "payment_processing_fees": 712.27,
      "successful_payments": 42,
      "failed_payments": 0
    },
    "previous_period": {
      "date_range": "2023-01-28 to 2023-01-29",
      "total_payouts": 25780.42,
      "currency": "USD",
      "payout_count": 38,
      "avg_payout": 678.43,
      "unique_creators_paid": 34,
      "total_content_rewarded": 142,
      "payment_processing_fees": 644.51,
      "successful_payments": 37,
      "failed_payments": 1
    },
    "changes": {
      "total_payouts": {
        "value": 2670.33,
        "percentage": 10.4
      },
      "payout_count": {
        "value": 4,
        "percentage": 10.5
      },
      "avg_payout": {
        "value": -1.03,
        "percentage": -0.15
      },
      "unique_creators_paid": {
        "value": 3,
        "percentage": 8.8
      },
      "total_content_rewarded": {
        "value": 14,
        "percentage": 9.9
      },
      "payment_processing_fees": {
        "value": 67.76,
        "percentage": 10.5
      },
      "successful_payments": {
        "value": 5,
        "percentage": 13.5
      },
      "failed_payments": {
        "value": -1,
        "percentage": -100
      }
    }
  }
} 
```

```bash cURL theme={"dark"}
curl -X GET "https://api.growi.io/api/public/v1/stats/payouts_24h?start_date=01/01/2023&end_date=01/31/2023" \
     -H "Authorization: Bearer YOUR_PUBLIC_API_KEY" \
     -H "Content-Type: application/json"
```

```json 200 theme={"dark"}
{
  "success": true,
  "data": {
    "current_period": {
      "date_range": "2023-01-30 to 2023-01-31",
      "total_payouts": 28450.75,
      "currency": "USD",
      "payout_count": 42,
      "avg_payout": 677.40,
      "unique_creators_paid": 37,
      "total_content_rewarded": 156,
      "payment_processing_fees": 712.27,
      "successful_payments": 42,
      "failed_payments": 0
    },
    "previous_period": {
      "date_range": "2023-01-28 to 2023-01-29",
      "total_payouts": 25780.42,
      "currency": "USD",
      "payout_count": 38,
      "avg_payout": 678.43,
      "unique_creators_paid": 34,
      "total_content_rewarded": 142,
      "payment_processing_fees": 644.51,
      "successful_payments": 37,
      "failed_payments": 1
    },
    "changes": {
      "total_payouts": {
        "value": 2670.33,
        "percentage": 10.4
      },
      "payout_count": {
        "value": 4,
        "percentage": 10.5
      },
      "avg_payout": {
        "value": -1.03,
        "percentage": -0.15
      },
      "unique_creators_paid": {
        "value": 3,
        "percentage": 8.8
      },
      "total_content_rewarded": {
        "value": 14,
        "percentage": 9.9
      },
      "payment_processing_fees": {
        "value": 67.76,
        "percentage": 10.5
      },
      "successful_payments": {
        "value": 5,
        "percentage": 13.5
      },
      "failed_payments": {
        "value": -1,
        "percentage": -100
      }
    }
  }
} 
```


## OpenAPI

````yaml GET /stats/payouts_24h
openapi: 3.0.1
info:
  title: Growi API
  description: >-
    API documentation for Growi platform, showcasing the public tracking event
    endpoint
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.growi.io/api/public/v1
security:
  - bearerAuth: []
paths:
  /stats/payouts_24h:
    get:
      description: Retrieves payout data with comparison to previous period
      parameters:
        - name: start_date
          in: query
          required: true
          example: 10/01/2025
          schema:
            type: string
            format: date
            default: 10/01/2025
          description: Start date in MM/DD/YYYY format
        - name: end_date
          in: query
          required: true
          example: 11/14/2025
          schema:
            type: string
            format: date
            default: 11/14/2025
          description: End date in MM/DD/YYYY format
        - name: limit
          in: query
          required: false
          example: 4
          schema:
            type: integer
            default: 4
          description: >-
            Limit the number of results. Default is 4. Recommended is 20. Set to
            10,000 to get all data.
      responses:
        '200':
          description: Payouts 24h data retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    description: Payouts 24h data
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      deprecated: true
components:
  schemas:
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: string
        message:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.