Skip to main content

Base URL

All endpoints are under /v1. The MCP server for agents is at /mcp (Connect an agent).

Authentication

None needed. Every endpoint, including the MCP server, works without a key or sign-up:
Apps that need a higher limit can be given a key; send it as Authorization: Bearer ov_live_.... Keys go in headers only, never in the URL.

Rate limits

The API is free. Limits are only there to keep it fair: The per-minute limit refills evenly, so short bursts are fine; the daily limit resets at 00:00 UTC. Every response tells you where you stand: GET /v1/me returns your current limits.

Conventions

  • IDs. Albums are m…, g… or r… (see Albums and pressings). Pressings use the Discogs release ID.
  • Codes as printed. Barcodes, catalog numbers and runouts can be sent exactly as they appear on the record. Spaces, dashes and case are ignored.
  • Album first. Lookups return albums. Pressings are included where they matched, and can be ignored.
  • Provenance. Values carry their source. Derived values carry their rule and confidence.

Errors

Errors return a JSON body with detail: