List your collection

List the releases in your Discogs collection, with folder.

GET https://cotlet.dev/api/v1/discogs/collections

read

Returns collection items with release, folder and the date added. Use it to check whether a release is already in your collection before you add it.

Parameters

Parameters: list_collection
NameTypeDescription
folder string string Folder name. Leave out for all folders.
page integer integer Page number, starting at 1.

Request

cURL
curl https://cotlet.dev/api/v1/discogs/collections \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("discogs", "list_collection")
Node.js
const result = await cotlet.call('discogs', 'list_collection');
CLI
cotlet call discogs list_collection

Example response

JSON

{
  "items": [
    {
      "release_id": 4417820,
      "title": "Night Drive / Blue Room",
      "folder": "Uncategorized",
      "added": "2026-09-02"
    }
  ],
  "page": 1,
  "pages": 1
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.