Collecting

List vinyl collection

GET https://api.rewind.rest/v1/collecting/vinyl

Paginated, filterable, searchable Discogs vinyl collection with artist and image data.

Authorization

Authorizationheaderstringrequired

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

Query Parameters

pagequeryinteger

limitqueryinteger

formatquerystring

genrequerystring

artistquerystring

sortquerystring

orderquerystring

qquerystring

datequerystring

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

fromquerystring

Range start, inclusive (ISO 8601)

toquerystring

Range end, inclusive (ISO 8601)

Response

application/json

Paginated collection items

dataarray of objectrequired

properties

paginationobjectrequired

properties

cURL

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

200

{
  "data": [
    {
      "id": 0,
      "discogs_id": 0,
      "title": "string",
      "artists": [
        "\u2026"
      ],
      "year": 0,
      "format": "string",
      "format_detail": "string",
      "label": "string",
      "genres": [
        "\u2026"
      ],
      "styles": [
        "\u2026"
      ],
      "image": {
        "url": "\u2026",
        "thumbhash": "\u2026",
        "dominant_color": "\u2026",
        "accent_color": "\u2026"
      },
      "date_added": "string",
      "rating": 0,
      "discogs_url": "string"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "total_pages": 8
  }
}