Discogs Master Release Versions API

Use the Discogs Master Release Versions API to retrieve pressings, formats and reissues of a music master release, with labels, catalogue numbers, countries and release dates. Provide source record ID (id); refine the result with release format (format), record-label filter (label). Compare pressings and reissues, match format or catalogue numbers and distinguish editions of the same master release. Versions are pressings, formats or reissues of a musical master release; format and catalogue identity should stay attached to each version. The detail page provides the supported parameters, request examples, available response examples and usage pricing for this operation.

Selected price
$0.002 / billing creditPublished pricing
Sellers / implementations
1 / 1
Requests · 30d
—Loading...
Success rate · 30d
—Loading...

Run sends a real API request. Charges follow the published API contract.

Request parameters
Master id or a discogs.com/master/<id> link.
Optional parameters (13)
e.g. Vinyl, CD.
Label.
Release year.
Country.
Sort field.
Sort order.
Results per page (1-100, default 50).
Page number (1-based).
0 leaves out the bulky `raw` source blocks (often 10-30x smaller).
Comma-separated fields to return, e.g. `posts.id,posts.title`. Call metadata is always included.
1 skips the 24-hour cache and fetches live.
JSON only for this OpenAny product. Omit output or use json; CSV and NDJSON exports are not exposed.
Native CSV/NDJSON record selector; it has no effect on this JSON-only product.

Sample response

{
  "cached": false,
  "count": 50,
  "credits_used": 1,
  "filter_facets": [
    {
      "allows_multiple_values": true,
      "id": "format",
      "title": "Format",
      "values": [
        {
          "count": 174,
          "title": "Album",
          "value": "Album"
        },
        {
          "count": 90,
          "title": "CD",
          "value": "CD"
        },
        "… 29 more"
      ]
    },
    {
      "allows_multiple_values": true,
      "id": "label",
      "title": "Label",
      "values": [
        {
          "count": 98,
          "title": "Geffen Records",
          "value": "Geffen+Records"
        },
        {
          "count": 89,
          "title": "Geffen Records, Inc.",
          "value": "Geffen+Records%2C+Inc."
        },
        "… 167 more"
      ]
    },
    "… 2 more"
  ],
  "filters": {
    "applied": {},
    "available": {
      "country": {
        "Algeria": 1,
        "Argentina": 6,
        "Australia": 3,
        "Belarus": 2,
        "Brazil": 2,
        "Bulgaria": 2,
        "Canada": 7,
        "Chile": 1,
        "China": 2,
        "Colombia": 3,
        "Europe": 27,
        "Hungary": 1,
        "India": 4,
        "Indonesia": 5,
        "Israel": 1,
        "Italy": 4,
        "Japan": 12,
        "Malaysia": 2,
        "Mexico": 4,
        "Philippines": 1,
        "Poland": 4,
        "Russia": 22,
        "Russia & CIS": 1,
        "Singapore": 1,
        "Singapore & Malaysia": 1,
        "South Africa": 2,
        "South Korea": 4,
        "Spain": 2,
        "Taiwan": 2,
        "Thailand": 2,
        "Turkey": 1,
        "UK": 2,
        "UK & US": 1,
        "US": 31,
        "Ukraine": 4,
        "Unknown": 4,
        "Venezuela": 1,
        "Worldwide": 1
      },
      "format": {
        "Advance": 1,
        "Album": 174,
        "All Media": 2,
        "CD": 90,
        "CD-ROM": 1,
        "CDr": 3,
        "Cassette": 68,
        "Club Edition": 13,
        "Compilation": 1,
        "DVD": 1,
        "DVD-Video": 1,
        "Etched": 1,
        "File": 1,
        "LP": 14,
        "Limited Edition": 12,
        "MP3": 1,
        "Misprint": 1,
        "NTSC": 1,
        "Numbered": 2,
        "Partially Unofficial": 1,
        "Picture Disc": 1,
        "Promo": 10,
        "Reissue": 47,
        "Remastered": 2,
        "Repress": 5,
        "Single Sided": 1,
        "Special Edition": 1,
        "Stereo": 15,
        "Test Pressing": 1,
        "Unofficial Release": 38,
        "Vinyl": 14
      },
      "label": {
        "Bmg": 15,
        "Bmg Ariola De Colombia S.A.": 3,
        "Bmg Australia Limited": 7,
        "Bmg Direct": 4,
        "Cinram": 4,
        "Civic Center, Springfield": 42,
        "Columbia House": 6,
        "Dadc": 3,
        "Del Mar Fairgrounds": 44,
        "Dgc": 47,
        "Emi Virgin Songs, Inc.": 35,
        "Fujisankei Communications International Inc.": 7,
        "Gateway Mastering": 41,
        "Geffen Records": 98,
        "Geffen Records, Inc.": 89,
        "Global Music": 3,
        "Great Western Forum": 40,
        "London Astoria": 42,
        "Mca Music Entertainment": 6,
        "Mca Records": 7,
        "Mca Victor, Inc.": 3,
        "Paradiso Amsterdam": 39,
        "Paramount Theatre, Seattle": 46,
        "Pier 48": 42,
        "Pt. Ris Music Wijaya International": 4,
        "Seattle Center Arena": 42,
        "Stereoral": 8,
        "Teatro Castello, Roma": 40,
        "The End Of Music": 34,
        "The Reading Festival": 79,
        "Um³/Usm Japan": 4,
        "Uni Distribution Corp.": 27,
        "Universal": 5,
        "Universal International Music B.V.": 4,
        "Universal Music": 4,
        "Universal Music K.K.": 6,
        "Universal Music Llc": 4,
        "Vpro": 6,
        "Vpro Tv Studio \"De Plantage\"": 5,
        "Westwood One": 12,
        "…": "129 more fields"
      },
      "released": {
        "1996": 92,
        "1997": 5,
        "1999": 3,
        "2000": 2,
        "2002": 1,
        "2003": 5,
        "2005": 2,
        "2006": 2,
        "2007": 2,
        "2009": 2,
        "2010": 1,
        "2011": 2,
        "2012": 2,
        "2015": 1,
        "2016": 3,
        "2021": 1,
        "2023": 1
      }
    }
  },
  "master_id": 42473,
  "next_page": 2,
  "page": 1,
  "per_page": 50,
  "total": 176,
  "total_pages": 4,
  "versions": [
    {
      "catno": "GEC 25105",
      "country": "Hungary",
      "format": "Album",
      "id": 6816327,
      "label": "DGC",
      "major_formats": [
        "Cassette"
      ],
      "released": "1996",
      "stats": {
        "community": {
          "in_collection": 14,
          "in_wantlist": 92
        }
      },
      "status": "Accepted",
      "title": "From The Muddy Banks Of The Wishkah",
      "url": "https://www.discogs.com/release/6816327"
    },
    {
      "catno": "GEFC-25105",
      "country": "Argentina",
      "format": "Album, Stereo",
      "id": 28375483,
      "label": "Geffen Records",
      "major_formats": [
        "Cassette"
      ],
      "released": "1996",
      "stats": {
        "community": {
          "in_collection": 3,
          "in_wantlist": 26
        }
      },
      "status": "Accepted",
      "title": "From The Muddy Banks Of The Wishkah",
      "url": "https://www.discogs.com/release/28375483"
    },
    "… 48 more"
  ]
}

Response result

Response structure

Inferred from examples
  • cachedboolean
  • countinteger
  • credits_usedinteger
  • filter_facets(object | string)[]
    • allows_multiple_valuesboolean
    • idstring
    • titlestring
    • values(object | string)[]
      • countinteger
      • titlestring
      • valuestring
  • filtersobject
    • appliedobject
    • availableobject
      • countryobject
        • Algeriainteger
        • Argentinainteger
        • Australiainteger
        • Belarusinteger
        • Brazilinteger
        • Bulgariainteger
        • Canadainteger
        • Chileinteger
        • Chinainteger
        • Colombiainteger
        • Europeinteger
        • Hungaryinteger
        • Indiainteger
        • Indonesiainteger
        • Israelinteger
        • Italyinteger
        • Japaninteger
        • Malaysiainteger
        • Mexicointeger
        • Philippinesinteger
        • Polandinteger
        • Russiainteger
        • Russia & CISinteger
        • Singaporeinteger
        • Singapore & Malaysiainteger
        • South Africainteger
        • South Koreainteger
        • Spaininteger
        • Taiwaninteger
        • Thailandinteger
        • Turkeyinteger
        • UKinteger
        • UK & USinteger
        • USinteger
        • Ukraineinteger
        • Unknowninteger
        • Venezuelainteger
        • Worldwideinteger
      • formatobject
        • Advanceinteger
        • Albuminteger
        • All Mediainteger
        • CDinteger
        • CD-ROMinteger
        • CDrinteger
        • Cassetteinteger
        • Club Editioninteger
        • Compilationinteger
        • DVDinteger
        • DVD-Videointeger
        • Etchedinteger
        • Fileinteger
        • LPinteger
        • Limited Editioninteger
        • MP3integer
        • Misprintinteger
        • NTSCinteger
        • Numberedinteger
        • Partially Unofficialinteger
        • Picture Discinteger
        • Promointeger
        • Reissueinteger
        • Remasteredinteger
        • Repressinteger
        • Single Sidedinteger
        • Special Editioninteger
        • Stereointeger
        • Test Pressinginteger
        • Unofficial Releaseinteger
        • Vinylinteger
      • labelobject
        • Bmginteger
        • Bmg Ariola De Colombia S.A.integer
        • Bmg Australia Limitedinteger
        • Bmg Directinteger
        • Cinraminteger
        • Civic Center, Springfieldinteger
        • Columbia Houseinteger
        • Dadcinteger
        • Del Mar Fairgroundsinteger
        • Dgcinteger
        • Emi Virgin Songs, Inc.integer
        • Fujisankei Communications International Inc.integer
        • Gateway Masteringinteger
        • Geffen Recordsinteger
        • Geffen Records, Inc.integer
        • Global Musicinteger
        • Great Western Foruminteger
        • London Astoriainteger
        • Mca Music Entertainmentinteger
        • Mca Recordsinteger
        • Mca Victor, Inc.integer
        • Paradiso Amsterdaminteger
        • Paramount Theatre, Seattleinteger
        • Pier 48integer
        • Pt. Ris Music Wijaya Internationalinteger
        • Seattle Center Arenainteger
        • Stereoralinteger
        • Teatro Castello, Romainteger
        • The End Of Musicinteger
        • The Reading Festivalinteger
        • Um³/Usm Japaninteger
        • Uni Distribution Corp.integer
        • Universalinteger
        • Universal International Music B.V.integer
        • Universal Musicinteger
        • Universal Music K.K.integer
        • Universal Music Llcinteger
        • Vprointeger
        • Vpro Tv Studio "De Plantage"integer
        • Westwood Oneinteger
        • …string
      • releasedobject
        • 1996integer
        • 1997integer
        • 1999integer
        • 2000integer
        • 2002integer
        • 2003integer
        • 2005integer
        • 2006integer
        • 2007integer
        • 2009integer
        • 2010integer
        • 2011integer
        • 2012integer
        • 2015integer
        • 2016integer
        • 2021integer
        • 2023integer
  • master_idinteger
  • next_pageinteger
  • pageinteger
  • per_pageinteger
  • totalinteger
  • total_pagesinteger
  • versions(object | string)[]
    • catnostring
    • countrystring
    • formatstring
    • idinteger
    • labelstring
    • major_formatsstring[]
    • releasedstring
    • statsobject
      • communityobject
        • in_collectioninteger
        • in_wantlistinteger
    • statusstring
    • titlestring
    • urlstring

Loading related APIs…

Common questions

Do I need a separate key for every provider?

Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.

Are these providers interchangeable?

No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.

How is this API billed?

API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.

Where do the price and contract come from?

The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.

How do OpenAny Balance and x402 differ?

OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.

Does Playground send a paid request?

Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.

Use Discogs Master Release Versions API with your agent

Inspect endpoint contracts and confirm availability and pricing before a paid call.