Source: https://dinakar-rewind.docs.pageloop.ai/api-reference/attending/getattendingyearinreview

# Year in review

GET `https://api.rewind.rest/v1/attending/year/{year}`

Returns a year-in-review summary for attended events: totals, monthly breakdown, top venues, top concert performers, and the full event list. 404 when no attended events exist for the year.

## Authorization

#### Authorization (header, string, required)

API key. Read keys (rw\_live\_...) access GET endpoints. Admin keys (rw\_admin\_...) access all endpoints.

## Path Parameters

#### year (path, integer, required)

## Response

#### 200

Year in review

#### year (number, required)

#### total\_events (number, required)

#### total\_spent\_cents (number, required)

#### by\_category (array of object, required)

#### properties

#### category (string, required)

#### count (number, required)

#### by\_event\_type (array of object, required)

#### properties

#### event\_type (string, required)

#### count (number, required)

#### monthly (array of object, required)

#### properties

#### month (string, required)

#### count (number, required)

#### top\_venues (array of object, required)

#### properties

#### venue\_id (number, required)

#### name (string, required)

#### city (string, required)

#### count (number, required)

#### top\_performers (array of object, required)

#### properties

#### performer\_id (number, required)

#### name (string, required)

#### count (number, required)

#### events (array of object, required)

#### properties

#### id (number, required)

#### event\_date (string, required)

#### event\_type (string, required)

#### title (string, required)

#### subtitle (string, required)

#### venue\_name (string, required)

#### 400

Bad request

#### error (string, required)

#### status (integer, required)

#### 401

Unauthorized

#### error (string, required)

#### status (integer, required)

#### 404

Not found

#### error (string, required)

#### status (integer, required)

#### Request

```bash cURL
curl -X GET 'https://api.rewind.rest/v1/attending/year/{year}' \
  -H 'Authorization: Bearer <token>'
```

```javascript JavaScript
const res = await fetch('https://api.rewind.rest/v1/attending/year/{year}', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <token>',
  },
});
const data = await res.json();
```

```python Python
import requests

res = requests.get(
    'https://api.rewind.rest/v1/attending/year/{year}',
    headers={'Authorization': 'Bearer <token>'}
)
data = res.json()
```

#### Response

```json 200
{
  "year": 0,
  "total_events": 0,
  "total_spent_cents": 0,
  "by_category": [
    {
      "category": "string",
      "count": 0
    }
  ],
  "by_event_type": [
    {
      "event_type": "string",
      "count": 0
    }
  ],
  "monthly": [
    {
      "month": "2024-08",
      "count": 0
    }
  ],
  "top_venues": [
    {
      "venue_id": 0,
      "name": "string",
      "city": "string",
      "count": 0
    }
  ],
  "top_performers": [
    {
      "performer_id": 0,
      "name": "string",
      "count": 0
    }
  ],
  "events": [
    {
      "id": 0,
      "event_date": "string",
      "event_type": "string",
      "title": "string",
      "subtitle": "string",
      "venue_name": "string"
    }
  ]
}
```

```json 400
{
  "error": "Not found",
  "status": 404
}
```

```json 401
{
  "error": "Not found",
  "status": 404
}
```

```json 404
{
  "error": "Not found",
  "status": 404
}
```