# Fundraising goals

**`GET /v1/goals`** · Secret or public key · scope `goals:read`

Your fundraising goals, newest first. `raised` includes the amount you started the goal with (the «Начать сбор с» (Start collecting from) field) and every Donatty donation to the goal, including ones rejected by moderation. Donation Alerts goals and widget settings are not counted, so the amount may differ from what the widget shows on stream.

## Parameters

| Name | In | Type | Description |
|---|---|---|---|
| `status` | query | string, values: `ACTIVE`, `CLOSED` | `ACTIVE` — the goal is running, `CLOSED` — it is finished. Without it, all goals. |
| `limit` | query | integer, 1–100, default `20` | How many records to return per page: 1 to 100, 20 by default. |
| `cursor` | query | string | `nextCursor` from the previous response; returns the next page. |

## Responses

- `200` — OK
- `400` — A parameter is invalid, or the key was sent in the request address: [`invalid_parameter`](https://developers.donatty.com/en/errors/invalid_parameter.md), [`token_in_query`](https://developers.donatty.com/en/errors/token_in_query.md)
- `401` — The key is missing, unknown, deleted or expired: [`missing_token`](https://developers.donatty.com/en/errors/missing_token.md), [`invalid_token`](https://developers.donatty.com/en/errors/invalid_token.md), [`token_expired`](https://developers.donatty.com/en/errors/token_expired.md)
- `403` — Wrong kind of key, the key lacks the `goals:read` scope, or the public key came from an address that is not in its list: [`wrong_token_type`](https://developers.donatty.com/en/errors/wrong_token_type.md), [`insufficient_scope`](https://developers.donatty.com/en/errors/insufficient_scope.md), [`origin_not_allowed`](https://developers.donatty.com/en/errors/origin_not_allowed.md)
- `429` — Rate limit exceeded: [`rate_limited`](https://developers.donatty.com/en/errors/rate_limited.md)
- `500` — The request failed on our side: [`internal_error`](https://developers.donatty.com/en/errors/internal_error.md)
- `503` — The API is temporarily unavailable: [`service_unavailable`](https://developers.donatty.com/en/errors/service_unavailable.md)

## Example response

```json
{
  "items": [
    {
      "id": "goal_7e3a9c10-4b2d-4f8e-a1c6-0d9b8e7f6a52",
      "title": "New microphone",
      "target": {
        "value": "15000.00",
        "currency": "RUB"
      },
      "raised": {
        "value": "6420.50",
        "currency": "RUB"
      },
      "status": "ACTIVE",
      "endsAt": "2026-12-31T21:00:00Z",
      "createdAt": "2026-10-01T12:00:00Z"
    }
  ],
  "nextCursor": "MTc5MDg1NjAwMDAwMDAwMC43ZTNhOWMxMC00YjJkLTRmOGUtYTFjNi0wZDliOGU3ZjZhNTI"
}
```

## Schemas

### GoalPage

| Field | Type | Description |
|---|---|---|
| `items` | list `Goal` |  |
| `nextCursor` | string or null | Pass as `cursor` to get the next page; `null` — last page. |

### Goal

| Field | Type | Description |
|---|---|---|
| `id` | string | Goal identifier, `goal_…`. |
| `title` | string | Goal title. |
| `target` | `Money` | The amount to raise. |
| `raised` | `Money` | The amount raised: the amount you started the goal with (the «Начать сбор с» (Start collecting from) field) plus Donatty donations to this goal, including ones rejected by moderation. |
| `status` | string, values: `ACTIVE`, `CLOSED` | `ACTIVE` — running, `CLOSED` — finished. |
| `endsAt` | string (date-time) or null | When the goal ends; `null` when no end is set. |
| `createdAt` | string (date-time) | When the goal was created. |

### Money

| Field | Type | Description |
|---|---|---|
| `value` | string | Decimal amount with two fraction digits. |
| `currency` | string | ISO 4217 code. |
