Skip to main content
GET
/
v1
/
collecting
/
cross-reference
Collection-listening cross-reference
curl --request GET \
  --url https://api.rewind.rest/v1/collecting/cross-reference \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "collection": {
        "id": 1,
        "discogs_id": 6872464,
        "title": "Nevermind",
        "artists": [
          "Nirvana"
        ],
        "year": 1991,
        "format": "Vinyl",
        "genres": [
          "Rock"
        ],
        "styles": [
          "Grunge"
        ],
        "image": null,
        "date_added": "2026-03-11T16:05:58-07:00",
        "rating": 0,
        "discogs_url": "https://www.discogs.com/release/6872464"
      },
      "listening": {
        "album_name": "Nevermind",
        "artist_name": "Nirvana",
        "play_count": 333,
        "last_played": "2026-02-15T20:00:00Z",
        "match_type": "exact",
        "match_confidence": 1
      }
    }
  ],
  "summary": {
    "total_matches": 50,
    "listen_rate": 0.72,
    "unlistened_count": 14
  },
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 50,
    "total_pages": 3
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.rewind.rest/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

API key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.

Query Parameters

page
integer
default:1
Required range: x >= 1
limit
integer
default:20
Required range: 1 <= x <= 100
sort
string
default:plays
filter
string
default:all

Response

Cross-reference data with summary stats

data
object[]
required
summary
object
required
pagination
object
required