Return the Discogs identity (username, id, resource_url) of the currently authenticated user.

Search the Discogs database for releases, masters, artists, or labels. Supports free-text queries plus structured filters (artist, title, label, genre, style, year, format, country, barcode).

Fetch full details for a single release by its Discogs release ID.

Fetch details for a master release (the abstract release grouping all its pressings/versions).

List all known pressings/versions of a master release.

Fetch profile details for an artist by Discogs artist ID.

List releases and masters credited to an artist.

Fetch profile details for a record label by Discogs label ID.

List releases put out on a record label.

List the authenticated user's collection folders (e.g. "All", "Uncategorized", custom folders).

List the releases in a collection folder, with sort and pagination options.

Add a release to a collection folder.

Remove a specific instance of a release from a collection folder. Requires the instance_id returned by discogs_get_collection_items for that copy (a release can appear multiple times in a folder).

Update the personal rating and/or notes fields on a specific collection item instance.

Get the estimated minimum, median, and maximum marketplace value of the user's whole collection.

List releases on the authenticated user's wantlist.

Add a release to the authenticated user's wantlist, optionally with notes and a rating.

Remove a release from the authenticated user's wantlist.

Get the number of copies for sale and the lowest current price for a release.

Get Discogs' suggested price per condition grade for a release, based on recent marketplace sales. Requires the authenticated user to have marketplace seller settings configured.

Fetch a single marketplace listing by its listing ID.

List the marketplace listings for a given Discogs username (defaults to the authenticated user).

List a release for sale on the Discogs marketplace. This creates a real, publicly visible listing — confirm details with the user before calling.

Update an existing marketplace listing (price, condition, comments, status, etc).

Remove a marketplace listing. This is irreversible — confirm with the user before calling.

List the authenticated user's marketplace orders (as a seller), with optional status filter.

Fetch details for a single marketplace order.

Update a marketplace order's status, shipping price, or additional instructions. Changing status notifies the buyer — confirm with the user before calling.

List the message/status-change history for a marketplace order.

Post a message to a marketplace order's message thread, optionally also changing its status.