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

# Donors List

> Retrieve a paginated list of donors for a specific CrowdChange campaign, returning 10 donor records per page with name, amount, and donation date.

## Path parameters

<ParamField path="id" type="integer" required>
  Fundraiser ID.
</ParamField>

## Query parameters

<ParamField query="page" type="integer">
  Page number. Default: `1`
</ParamField>

<ParamField query="limit" type="integer">
  Number of results to return. Default: `10`
</ParamField>

<ParamField query="sort" type="string">
  Key to sort by. Allowed values: `id`, `amount` Default: `id`
</ParamField>

<ParamField query="direction" type="string">
  Direction of sorting. Allowed values: `asc`, `desc` Default: `desc`
</ParamField>

<ParamField query="min_total" type="integer">
  Minimum total donation amount to include. Default: `0`
</ParamField>

<ParamField query="only_received" type="boolean">
  Include only received transactions. Default: `false`
</ParamField>

## Response

Returns an array of objects with the following fields.

<ResponseField name="total" type="number">
  Donation total.
</ResponseField>

<ResponseField name="total_formatted" type="string">
  Formatted donation total, includes currency symbol.
</ResponseField>

<ResponseField name="amount_match" type="number">
  Matched amount for campaigns with donation matching enabled.
</ResponseField>

<ResponseField name="total_with_match" type="number">
  Donation total including the matched amount.
</ResponseField>

<ResponseField name="name" type="string">
  Donor's name or alias.
</ResponseField>

<ResponseField name="comment" type="string">
  Donor's comment.
</ResponseField>

<ResponseField name="is_amount_hidden" type="boolean">
  True if the donor chose to hide their donation amount.
</ResponseField>

<ResponseField name="currency" type="string">
  Currency code.
</ResponseField>

<ResponseField name="created_at" type="string">
  Date and time of the donation.
</ResponseField>

**Other responses**

| Status | Description |
| ------ | ----------- |
| `400`  | Bad Request |
| `403`  | Forbidden   |

<ResponseExample>
  ```json theme={null}
  [
    {
      "total": 100,
      "total_formatted": "$100",
      "amount_match": 100,
      "total_with_match": 200,
      "name": "John Snow",
      "comment": "Happy to support!",
      "is_amount_hidden": false,
      "currency": "USD",
      "created_at": "2021-01-01T00:00:00Z"
    }
  ]
  ```
</ResponseExample>