How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

MusicBrainz Identifiers API

Non-MBID lookups by ISRC, ISWC, and DiscID.

MusicBrainz Identifiers API is one of 16 APIs that MusicBrainz publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 5 JSON Schema definitions.

Tagged areas include Identifiers. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, authentication docs, rate-limit docs, a JSON-LD context, and 5 JSON Schemas.

This API exposes 4 operations across 4 paths, and defines 16 schemas. It is described by OpenAPI 3.2.0, at version 2.0.

Requests are made against 2 base URLs: https://musicbrainz.org/ws/2, https://beta.musicbrainz.org/ws/2.

4 operations 4 paths 16 schemas 4 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2.0
Base URL
https://musicbrainz.org/ws/2
Authentication
HTTP Basic, OAuth 2.0
Terms of Service
Resource Areas
1

Authentication & Security 2

MusicBrainz Identifiers API declares 2 security schemes for authenticating requests. It accepts HTTP basic authentication (HTTPBasic). It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 7 scopes.

  • HTTPBasic — HTTP Basic authentication using MusicBrainz editor credentials. Required for submission and user-specific endpoints.
  • OAuth2 — OAuth 2.0 authentication via the MusicBrainz OAuth server.

Paths & Operations 4

Across 4 paths, the API surfaces 4 operations — 4 GET. Each is listed below with its method, path, parameters, and response codes.

Identifiers 4

Non-MBID lookups by ISRC, ISWC, and DiscID.

GET
/url
Lookup Urls By Resource
lookupUrlsByResource 3 params → 200404429
GET
/isrc/{isrc}
Lookup Recordings By ISRC
lookupRecordingsByISRC 3 params → 200404429
GET
/iswc/{iswc}
Lookup Works By ISWC
lookupWorksByISWC 3 params → 200404429
GET
/discid/{discid}
Lookup Releases By Disc ID
lookupReleasesByDiscID 6 params → 200404429

Schemas 16

The contract defines 16 schemas that model the data the API accepts and returns. The most detailed are Release (23 properties), Artist (19 properties), Label (14 properties), Relation (13 properties). Each schema is shown below with its type and property counts.

Url
object
A URL linked to other MusicBrainz entities.
3 properties
Release
object
A specific issue of a release-group, with packaging, label, country, and barcode.
23 properties
Track
object
7 properties
Work
object
A distinct intellectual or artistic creation (song, composition, etc.).
12 properties
MBID
string
MusicBrainz Identifier (UUID v4) - the canonical primary key for every entity.
Area
object
A geographic area (country, subdivision, city, etc.).
10 properties
Relation
object
Typed relationship between two MusicBrainz entities.
13 properties
Rating
object
2 properties
Label
object
A record label or imprint.
14 properties
LifeSpan
object
Begin/end dates and whether the entity has ended.
3 properties
Error
object
2 properties
Alias
object
Alternative name for an entity.
7 properties
ReleaseGroup
object
A logical grouping of releases (e.g. an album and its reissues).
12 properties
Recording
object
A distinct audio capture of a performance.
12 properties
Tag
object
2 properties
Artist
object
A person, group, orchestra, choir, character, or other artistic entity.
19 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

musicbrainz-identifiers-api-openapi.yml Raw ↑

Other APIs MusicBrainz publishes across the network.

MusicBrainz Areas API
MusicBrainz Artists API
MusicBrainz Collections API
MusicBrainz Events API
MusicBrainz Genres API
MusicBrainz Instruments API
MusicBrainz Labels API
MusicBrainz Places API
MusicBrainz Recordings API
MusicBrainz Release Groups API
MusicBrainz Releases API
MusicBrainz Series API
Where this information came from

This is an independent, third-party profile of MusicBrainz Identifiers API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.