Discogs Release API Documentation Get one release by its Discogs id. The answer has title, artists, labels with catalog numbers, formats with descriptions, genres, styles, the full tracklist with positions and durations, credits, identifiers such as barcodes and matrix numbers, notes, images, videos, the master id and the community numbers: have, want, rating average and rating count. The marketplace block has the number of copies for sale and the lowest asking price in the currency you ask for. Find release ids with the search endpoint. Add include_sales_stats=true to get the low, median and high sale price and the date of the last sale from the release page. Each statistics price has its own currency. If Discogs shows no sales block, the field is left out and the add-on is not charged. Suggested prices and the sold price of single listings need a Discogs login and are not available. Cost: 1 credit per release. The sales statistics add-on costs 1 more credit (2 in total). An unknown release (404) and every error cost nothing.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
2 optional filters available.
integer
Required
Discogs release id. Example: 249504. Take it from the search endpoint.
1234567890
string
Optional
Currency of the lowest price: USD, EUR, GBP, AUD, CAD, JPY, CHF, MXN, BRL, NZD, SEK or ZAR. Default: USD.
USD
boolean
Optional
true to add the low, median and high sale price and the last sale date. Costs 1 more credit. Default: false.
true
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"id": 249504,
"url": "https://www.discogs.com/release/249504-Rick-Astley-Never-Gonna-Give-You-Up",
"year": 1987,
"title": "Never Gonna Give You Up",
"genres": [
"Electronic",
"Pop"
],
"images": [
{
"url": "https://i.discogs.com/-DPFA5hKT8i91jnjn4rLB1zSiuUBFTrGWspu1TpLV30/rs:fit/g:sm/q:90/h:600/w:600/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTI0OTUw/NC0xMzM0NTkyMjEy/LmpwZWc.jpeg",
"type": "primary",
"width": 600,
"height": 600
}
],
"labels": [
{
"id": 895,
"name": "RCA",
"catalog_number": "PB 41447"
}
],
"status": "Accepted",
"styles": [
"Euro-Disco"
],
"videos": [
{
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
"duration_s": 214
}
],
"artists": [
{
"id": 72872,
"name": "Rick Astley"
}
],
"country": "UK",
"credits": [
{
"id": 547352,
"name": "Me Company",
"role": "Design",
"credited_as": "Me Co"
}
],
"formats": [
{
"name": "Vinyl",
"quantity": 1,
"descriptions": [
"7\"",
"45 RPM",
"Single",
"Stereo"
]
}
],
"released": "1987-07-00",
"community": {
"have": 4165,
"want": 594,
"rating_count": 250,
"rating_average": 3.88
},
"companies": [
{
"id": 82835,
"name": "BMG Records (UK) Ltd.",
"type": "Phonographic Copyright (p)"
}
],
"master_id": 96559,
"tracklist": [
{
"type": "track",
"title": "Never Gonna Give You Up",
"duration": "3:32",
"position": "A"
},
{
"type": "track",
"title": "Never Gonna Give You Up (Instrumental)",
"duration": "3:30",
"position": "B"
}
],
"date_added": "2004-04-30T08:10:05-07:00",
"identifiers": [
{
"type": "Barcode",
"value": "5012394144777"
}
],
"marketplace": {
"currency": "EUR",
"lowest_price": 0.68,
"num_for_sale": 125,
"blocked_from_sale": false
},
"data_quality": "Correct",
"date_changed": "2022-08-03T03:03:28-07:00",
"sales_statistics": {
"low": {
"amount": 0.62,
"currency": "USD"
},
"high": {
"amount": 9.64,
"currency": "USD"
},
"median": {
"amount": 2.3,
"currency": "USD"
},
"last_sale_date": "2025-10-02"
},
"estimated_weight_g": 230
},
"meta": {
"credits": 5,
"billable": true,
"endpoint_family": "release"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A query parameter is missing or invalid. This response is not billable.
{
"errors": {
"id": [
"A release id is required, e.g. 249504. Take it from the search endpoint."
]
},
"message": "The request validation failed"
}Release Not Found
No release with this id exists on Discogs. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "release"
},
"error": {
"code": "NOT_FOUND",
"message": "No release with this id exists on Discogs."
},
"success": false
}Service Unavailable
Discogs could not be reached, refused the request or changed its answer. This response is not billable. Retry later.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "release"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The Discogs API is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.