Source: https://dinakar-rewind.docs.pageloop.ai/api-reference/collecting/getcollectingstats

# Collection stats

GET `https://api.rewind.rest/v1/collecting/stats`

Aggregate statistics for the vinyl collection. Supports optional date filtering to scope stats to items added within a time period.

## Authorization

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

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

## Query Parameters

#### date (query, string)

Single day (YYYY-MM-DD). Overrides from/to.

#### from (query, string)

Range start, inclusive (ISO 8601)

#### to (query, string)

Range end, inclusive (ISO 8601)

## Response

#### 200

Collection statistics

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

#### by\_format (object)

#### wantlist\_count (number, required)

#### unique\_artists (number, required)

#### estimated\_value (number, required)

#### top\_genre (string, required)

#### oldest\_release\_year (number, required)

#### newest\_release\_year (number, required)

#### most\_collected\_artist (object)

#### added\_this\_year (number, required)

#### 401

Unauthorized

#### error (string, required)

#### status (integer, required)

#### 500

Internal server error

#### error (string, required)

#### status (integer, required)

#### Request

```bash cURL
curl -X GET 'https://api.rewind.rest/v1/collecting/stats' \
  -H 'Authorization: Bearer <token>'
```

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

```python Python
import requests

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

#### Response

```json 200
{
  "total_items": 0,
  "by_format": {},
  "wantlist_count": 0,
  "unique_artists": 0,
  "estimated_value": 0,
  "top_genre": "string",
  "oldest_release_year": 0,
  "newest_release_year": 0,
  "most_collected_artist": {},
  "added_this_year": 0
}
```

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

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