Skip to content
Open Podcast API

Get capabilities

Endpoint
GET /v1/capabilities

The capabilities endpoint exposes details about the features a server supports. Capabilities are scoped by urn and MUST contain the following:

  • Each supported version of the feature.
  • The status of the feature version: STABLE | UNSTABLE | DEPRECATED.
  • The root relative URL the feature can be accessed at.

Each capabilities response MUST contain a urn:opa:core object that lists the versions of the Open Podcast API the server supports. Additional capabilities MAY be returned as separate urn objects with supported versions.

Example 200 response

Section titled “Example 200 response”
{
  "urn:opa:core": {
    "0.0.1": {
      "status": "DEPRECATED",
      "root": "/v0"
    },
    "1.0.0": {
      "status": "STABLE",
      "root": "/v1"
    },
    "2.0.0": {
      "status": "UNSTABLE",
      "root": "/v2"
    }
  },
  "urn:opa:extra:playcount": {
    "0.0.1": {
      "status": "DEPRECATED",
      "root": "/v0/playcount"
    },
    "1.0.0": {
      "status": "STABLE",
      "root": "/v1/playcount"
    },
    "2.0.0": {
      "status": "UNSTABLE",
      "root": "/v2/playcount"
    }
  }
}