From a barcode, a code or an artist and title to the album, then to the exact pressing.
Identification happens in two steps. The API gets you to the album right away. Getting to the exact pressing is optional, and your app decides how far to go.
1. Get the album
Barcode (best)
Scan the barcode on the back. It’s the most reliable input: 99.2% of Discogs vinyl barcodes belong to exactly one album, and 83.4% to exactly one pressing.
Pass the barcode as printed. Spaces, dashes and leading zeros don’t matter, and UPC-12 and EAN-13 forms of the same code match each other.The response’s match field tells you what to do next:
match
Meaning
Next step
one_pressing
Exactly one pressing has this barcode
Done
one_album
One album, several pressings
Stop at the album, or narrow (step 2)
several_albums
The barcode is shared by different albums (0.8% of barcodes)
Show the albums and let the user pick
none
Unknown barcode
Try artist and title, then consider a contribution
Decode the barcode on the device (for example with the browser’s BarcodeDetector API) and send only the digits. It’s faster and no image leaves the phone.
Word order doesn’t matter and “the” is ignored. Albums with many vinyl versions rank above one-off releases with similar names.
2. Narrow to the pressing
With filters and facets
GET /v1/albums/{id}/pressings filters the album’s pressings and returns facets: the count of each remaining value. Ask the user about the facet that splits the list best.
/v1/search also takes catno, barcode, label, country, artist, title and year, and scores each candidate by which fields matched. When pressings tie, note says what would separate them.
What separates tied pressings
In testing, pressings that tie on every code usually differ only in things no code captures: vinyl color, a limited edition, an insert, or the “Made in…” text on the back cover. Ask the user, or read it from a photo of the label.
Example: four real records
Record
Barcode result
Pressing decided by
The Flaming Lips, Yoshimi Battles the Pink Robots
one_album, 5 of 14 pressings
”Made in Canada” on the back cover
Twenty One Pilots, More Than We Ever Imagined
one_pressing
Barcode alone
Jay-Z / Linkin Park, Collision Course
one_album, 4 of 11 pressings
”Warner Bros. … Made in U.S.A.” on the back, then the label
Arcade Fire, The Suburbs
one_pressing
Barcode alone (2017 reissue)
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Open Vinyl","description":"Free vinyl record API: look up any record by barcode, catalog number, runout or artist. REST, MCP and CLI.","colors":{"primary":"#111111","light":"#ededed","dark":"#111111"},"logo":{"light":"https://mintcdn.com/openvinyl/z0tarV3EXcySoCUg/logo-light.svg?fit=max\u0026auto=format\u0026n=z0tarV3EXcySoCUg\u0026q=85\u0026s=c50dc60dfd1bdf88a3343fd68711903e","dark":"https://mintcdn.com/openvinyl/z0tarV3EXcySoCUg/logo-dark.svg?fit=max\u0026auto=format\u0026n=z0tarV3EXcySoCUg\u0026q=85\u0026s=b71579b0f499868bbe2b28cddfda5c36"},"favicon":"https://mintcdn.com/openvinyl/z0tarV3EXcySoCUg/favicon.svg?fit=max\u0026auto=format\u0026n=z0tarV3EXcySoCUg\u0026q=85\u0026s=9c7f2616fe470194fc1c186c741a6a5b","appearance":{"default":"dark"},"navbar":{"primary":{"type":"button","label":"openvinyl.dev","href":"https://openvinyl.dev"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"openvinyl","hasAudioNarration":false,"actualSubdomain":"openvinyl","customDomains":["docs.openvinyl.dev"],"gitSource":{"type":"github","owner":"pooowell","repo":"open-vinyl","deployBranch":"main","contentDirectory":"site","isPrivate":true,"mountPath":"","label":"","_id":"6afde44ef27a01c43ef41c1f"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aff223877c891d0ddc50528","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"Guides","count":14},{"language":"default","tag":"API reference","count":12},{"language":"default","tag":"Endpoints","count":11},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"Concepts","count":3},{"language":"default","tag":"Albums","count":3},{"language":"default","tag":"Contributions","count":2},{"language":"default","tag":"Identify","count":2},{"language":"default","tag":"System","count":2},{"language":"default","tag":"Overview","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"guides/identify-a-record","slug":"/guides/identify-a-record","pageMetadata":{"title":"Identify a record","description":"From a barcode, a code or an artist and title to the album, then to the exact pressing.","href":"/guides/identify-a-record"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"From a barcode, a code or an artist and title to the album, then to the exact pressing.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Mermaid,Table,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Identification happens in two steps. The API gets you to the `,_jsx(_components.strong,{children:`album`}),` right away. Getting to the exact `,_jsx(_components.strong,{children:`pressing`}),` is optional, and your app decides how far to go.`]}),`\n`,_jsx(Mermaid,{chart:`flowchart LR\n B[Barcode] --> A[Album]\n T[Artist and title] --> A\n A -->|optional| F[Filter and facets]\n C[Catalog number or runout] --> X[Pressing]\n F --> X`}),`\n`,_jsx(Heading,{level:`2`,id:`1-get-the-album`,children:`1. Get the album`}),`\n`,_jsx(Heading,{level:`3`,id:`barcode-best`,children:`Barcode (best)`}),`\n`,_jsx(_components.p,{children:`Scan the barcode on the back. It’s the most reliable input: 99.2% of Discogs vinyl barcodes belong to exactly one album, and 83.4% to exactly one pressing.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.openvinyl.dev/v1/albums?barcode=0%2093624%2095217%206\"`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Pass the barcode as printed. Spaces, dashes and leading zeros don’t matter, and UPC-12 and EAN-13 forms of the same code match each other.`}),`\n`,_jsxs(_components.p,{children:[`The response’s `,_jsx(_components.code,{children:`match`}),` field tells you what to do next:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`match`})}),_jsx(_components.th,{children:`Meaning`}),_jsx(_components.th,{children:`Next step`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`one_pressing`})}),_jsx(_components.td,{children:`Exactly one pressing has this barcode`}),_jsx(_components.td,{children:`Done`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`one_album`})}),_jsx(_components.td,{children:`One album, several pressings`}),_jsx(_components.td,{children:`Stop at the album, or narrow (step 2)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`several_albums`})}),_jsx(_components.td,{children:`The barcode is shared by different albums (0.8% of barcodes)`}),_jsx(_components.td,{children:`Show the albums and let the user pick`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`none`})}),_jsx(_components.td,{children:`Unknown barcode`}),_jsxs(_components.td,{children:[`Try artist and title, then consider a `,_jsx(_components.a,{href:`/guides/contributions`,children:`contribution`})]})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Decode the barcode on the device (for example with the browser’s `,_jsx(_components.code,{children:`BarcodeDetector`}),` API) and send only the digits. It’s faster and no image leaves the phone.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`artist-and-title`,children:`Artist and title`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.openvinyl.dev/v1/albums?q=jay-z%20blueprint\"`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Word order doesn’t matter and “the” is ignored. Albums with many vinyl versions rank above one-off releases with similar names.`}),`\n`,_jsx(Heading,{level:`2`,id:`2-narrow-to-the-pressing`,children:`2. Narrow to the pressing`}),`\n`,_jsx(Heading,{level:`3`,id:`with-filters-and-facets`,children:`With filters and facets`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`GET /v1/albums/{id}/pressings`}),` filters the album’s pressings and returns `,_jsx(_components.code,{children:`facets`}),`: the count of each remaining value. Ask the user about the facet that splits the list best.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.openvinyl.dev/v1/albums/m10362/pressings?country=US\u0026label=Harvest\u0026year=1973\"`})]}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`11`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`11`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`29`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"facets\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"plant\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Capitol Records Pressing Plant, Jacksonville\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`11`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Capitol Records Pressing Plant, Winchester\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`9`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Capitol Records Pressing Plant, Los Angeles\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`5`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"format\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [{ `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Stereo\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }, { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Repress\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`9`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.em,{children:`The Dark Side of the Moon`}),` goes from 674 pressings to 111 with `,_jsx(_components.code,{children:`country=US`}),`, then to 29 with `,_jsx(_components.code,{children:`label=Harvest\u0026year=1973`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`with-codes-from-the-record`,children:`With codes from the record`}),`\n`,_jsx(_components.p,{children:`The runout etching (the text scratched into the vinyl near the label) is the strongest pressing identifier. Any fragment works:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.openvinyl.dev/v1/search?runout=SMAS-1-11163%20F2\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`/v1/search`}),` also takes `,_jsx(_components.code,{children:`catno`}),`, `,_jsx(_components.code,{children:`barcode`}),`, `,_jsx(_components.code,{children:`label`}),`, `,_jsx(_components.code,{children:`country`}),`, `,_jsx(_components.code,{children:`artist`}),`, `,_jsx(_components.code,{children:`title`}),` and `,_jsx(_components.code,{children:`year`}),`, and scores each candidate by which fields matched. When pressings tie, `,_jsx(_components.code,{children:`note`}),` says what would separate them.`]}),`\n`,_jsx(Heading,{level:`3`,id:`what-separates-tied-pressings`,children:`What separates tied pressings`}),`\n`,_jsxs(_components.p,{children:[`In testing, pressings that tie on every code usually differ only in things no code captures: vinyl `,_jsx(_components.strong,{children:`color`}),`, a limited edition, an insert, or the “Made in…” text on the back cover. Ask the user, or read it from a photo of the label.`]}),`\n`,_jsx(Heading,{level:`2`,id:`example-four-real-records`,children:`Example: four real records`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Record`}),_jsx(_components.th,{children:`Barcode result`}),_jsx(_components.th,{children:`Pressing decided by`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`The Flaming Lips, `,_jsx(_components.em,{children:`Yoshimi Battles the Pink Robots`})]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`one_album`}),`, 5 of 14 pressings`]}),_jsx(_components.td,{children:`”Made in Canada” on the back cover`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Twenty One Pilots, `,_jsx(_components.em,{children:`More Than We Ever Imagined`})]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`one_pressing`})}),_jsx(_components.td,{children:`Barcode alone`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Jay-Z / Linkin Park, `,_jsx(_components.em,{children:`Collision Course`})]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`one_album`}),`, 4 of 11 pressings`]}),_jsx(_components.td,{children:`”Warner Bros. … Made in U.S.A.” on the back, then the label`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Arcade Fire, `,_jsx(_components.em,{children:`The Suburbs`})]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`one_pressing`})}),_jsx(_components.td,{children:`Barcode alone (2017 reissue)`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Identify a record","description":"From a barcode, a code or an artist and title to the album, then to the exact pressing.","href":"/guides/identify-a-record"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"1. Get the album","slug":"1-get-the-album","depth":2,"children":[{"title":"Barcode (best)","slug":"barcode-best","depth":3,"children":[]},{"title":"Artist and title","slug":"artist-and-title","depth":3,"children":[]}]},{"title":"2. Narrow to the pressing","slug":"2-narrow-to-the-pressing","depth":2,"children":[{"title":"With filters and facets","slug":"with-filters-and-facets","depth":3,"children":[]},{"title":"With codes from the record","slug":"with-codes-from-the-record","depth":3,"children":[]},{"title":"What separates tied pressings","slug":"what-separates-tied-pressings","depth":3,"children":[]}]},{"title":"Example: four real records","slug":"example-four-real-records","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"openvinyl","siteName":"Open Vinyl","title":"Identify a record - Open Vinyl","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T22:06:16.134Z","originalFileLocation":"guides/identify-a-record.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"From a barcode, a code or an artist and title to the album, then to the exact pressing.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Open Vinyl\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/openvinyl/ID41qnAA6Xu6IwlW/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/openvinyl/ID41qnAA6Xu6IwlW/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/openvinyl/ID41qnAA6Xu6IwlW/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/openvinyl/ID41qnAA6Xu6IwlW/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/openvinyl/ID41qnAA6Xu6IwlW/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/openvinyl/ID41qnAA6Xu6IwlW/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/openvinyl/ID41qnAA6Xu6IwlW/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/openvinyl/ID41qnAA6Xu6IwlW/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/openvinyl/ID41qnAA6Xu6IwlW/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Identify a record - Open Vinyl\">\u003cmeta data-mint-head property=\"og:description\" content=\"From a barcode, a code or an artist and title to the album, then to the exact pressing.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Open Vinyl\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.openvinyl.dev/guides/identify-a-record\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://openvinyl.mintlify.site/_mintlify/api/og/v2?division=Guides\u0026amp;title=Identify+a+record\u0026amp;description=From+a+barcode%2C+a+code+or+an+artist+and+title+to+the+album%2C+then+to+the+exact+pressing.\u0026amp;theme=5220b93fd4500b2b8fd2ea6d\u0026amp;signature=9e46858b1ca0bdc95c6f819af7fee133ea62a76206fcd4d170f7183f99b6fc83\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Identify a record - Open Vinyl\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"From a barcode, a code or an artist and title to the album, then to the exact pressing.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://openvinyl.mintlify.site/_mintlify/api/og/v2?division=Guides\u0026amp;title=Identify+a+record\u0026amp;description=From+a+barcode%2C+a+code+or+an+artist+and+title+to+the+album%2C+then+to+the+exact+pressing.\u0026amp;theme=5220b93fd4500b2b8fd2ea6d\u0026amp;signature=9e46858b1ca0bdc95c6f819af7fee133ea62a76206fcd4d170f7183f99b6fc83\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/openvinyl/ID41qnAA6Xu6IwlW/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Open Vinyl\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#111111\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.openvinyl.dev/guides/identify-a-record\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/identify-a-record.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.openvinyl.dev/#organization\",\"name\":\"Open Vinyl\",\"url\":\"https://docs.openvinyl.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/openvinyl/z0tarV3EXcySoCUg/logo-light.svg?fit=max\u0026auto=format\u0026n=z0tarV3EXcySoCUg\u0026q=85\u0026s=c50dc60dfd1bdf88a3343fd68711903e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.openvinyl.dev#website\",\"name\":\"Open Vinyl\",\"url\":\"https://docs.openvinyl.dev\",\"publisher\":{\"@id\":\"https://docs.openvinyl.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.openvinyl.dev/guides/identify-a-record#webpage\",\"url\":\"https://docs.openvinyl.dev/guides/identify-a-record\",\"name\":\"Identify a record\",\"description\":\"From a barcode, a code or an artist and title to the album, then to the exact pressing.\",\"dateModified\":\"2026-11-18T22:06:16.134Z\",\"isPartOf\":{\"@id\":\"https://docs.openvinyl.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.openvinyl.dev/guides/identify-a-record#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.openvinyl.dev/guides/identify-a-record#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Guides\",\"item\":\"https://docs.openvinyl.dev/guides/agents\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Identify a record\",\"item\":\"https://docs.openvinyl.dev/guides/identify-a-record\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.openvinyl.dev/guides/identify-a-record#article\",\"headline\":\"Identify a record\",\"name\":\"Identify a record\",\"description\":\"From a barcode, a code or an artist and title to the album, then to the exact pressing.\",\"url\":\"https://docs.openvinyl.dev/guides/identify-a-record\",\"mainEntityOfPage\":{\"@id\":\"https://docs.openvinyl.dev/guides/identify-a-record#webpage\"},\"dateModified\":\"2026-11-18T22:06:16.134Z\",\"publisher\":{\"@id\":\"https://docs.openvinyl.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.openvinyl.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Open Vinyl\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Open Vinyl\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/guides/identify-a-record.md","siteName":"Open Vinyl","nav":{"global":null,"tabs":[{"tab":"Guides","groups":[{"group":"Get started","pages":[{"title":"Open Vinyl","href":""},{"title":"Quickstart","href":"/quickstart"},{"title":"Catalog in numbers","mode":"wide","href":"/catalog"}]},{"group":"Concepts","pages":[{"title":"Albums and pressings","href":"/concepts/albums-and-pressings"},{"title":"Data sources","href":"/concepts/data-sources"},{"title":"Derived fields","href":"/concepts/derived-fields"}]},{"group":"Guides","pages":[{"title":"Connect an agent (MCP)","href":"/guides/agents"},{"title":"CLI","description":"ov: look up vinyl records from your terminal and connect your agent in one command.","href":"/guides/cli"},{"title":"Identify a record","href":"/guides/identify-a-record"},{"title":"Contributions","description":"Send values that are missing or wrong. They're stored for review and never change the catalog directly.","href":"/guides/contributions"}]}]},{"tab":"API reference","pages":[{"title":"API reference","href":"/api-reference/introduction"}]}]},"basePath":"","title":"Identify a record - Open Vinyl","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":[],"chunks":[]}