> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openvinyl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Open Vinyl

> A free API for vinyl records: identify any record from its barcode, catalog number, runout or artist and title.

One catalog of **8.1 million vinyl pressings** grouped into **3.9 million albums**, built from Discogs, MusicBrainz, Wikidata and the Cover Art Archive. Use it over REST, from your terminal, or from an agent over MCP.

Every lookup returns **albums**. Each album can carry the **pressings** that matched; narrowing to one pressing is an optional second step.

> [card] [Quickstart](https://docs.openvinyl.dev/quickstart.md)
>
> Your first lookup in one line.

> [card] [Identify a record](https://docs.openvinyl.dev/guides/identify-a-record.md)
>
> Barcode or codes first, then narrow to the exact pressing.

> [card] [Connect an agent](https://docs.openvinyl.dev/guides/agents.md)
>
> The MCP server and its tools.

> [card] [Catalog in numbers](https://docs.openvinyl.dev/catalog.md)
>
> What's in the catalog, by decade, country and genre.

## A barcode lookup

```bash theme={null}
curl "https://api.openvinyl.dev/v1/albums?barcode=889854626310"
```

```json theme={null}
{
  "match": "one_pressing",
  "albums": [{
    "id": "m264742",
    "artist": "Arcade Fire",
    "title": "The Suburbs",
    "year": 2010,
    "cover": "https://coverartarchive.org/release/6eebd8bd-7d09-4a84-8bc3-bcc629c1a424/4021472103-250.jpg",
    "pressings": {
      "matched": 1,
      "of_vinyl_versions": 6,
      "items": [{ "id": 11346765, "country": "UK, Europe & US", "year": 2017,
                  "label": [{ "name": "Columbia", "catno": "88985462631" }] }]
    }
  }]
}
```

## Report a problem

Wrong data, a broken endpoint, or something unclear in these docs: email [hello@openvinyl.dev](mailto:hello@openvinyl.dev?subject=Problem%20report). Include the request you made and what you expected.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.