Sonos

Sonos is a consumer audio company whose wireless home-sound systems are controlled programmatically through the Sonos Control API — a cloud-based REST API that lets third-party integrations discover a household's players and groups and drive playback, volume, grouping, favorites, playlists, home theater options, audio clips, and cloud-queue sessions. The API authenticates with OAuth 2.0 (authorization code grant) using the single playback-control-all scope, is organized into per-resource namespaces (households, groups, groupVolume, playback, playbackMetadata, playbackSession, playerVolume, favorites, playlists, audioClip, homeTheater), and delivers real-time state through an event-subscription (webhook callback) model.

Sonos publishes 1 API on the APIs.io network. Tagged areas include Company, Consumer, Audio, Music, and Smart Home.

The Sonos catalog on APIs.io includes 1 event-driven AsyncAPI specification.

Sonos’ developer surface includes documentation, API reference, getting-started guide, signup flow, support, authentication, and 15 more developer resources.

🌐 Visit website 📡 Source on GitHub

30.0/100 thin ▬ flat Agent 24/100 agent aware saas Full breakdown ↓
scored 2026-09-08 · rubric v0.20.0

AccessSelf serve

1 APIs

Company Consumer Audio Music Smart Home IoT Streaming Speakers Home Automation Voice

Kin Score

Kin Score How this is scored →
scored 2026-09-08 · rubric v0.20.0

Composite quality — 30.0/100 · thin

Contract Quality 10.4 / 25

Developer Ergonomics 7.5 / 20

Access Clarity 1.3 / 20

Operational Transparency 3.4 / 13

Contract Governance 0.5 / 12

Discoverability 6.9 / 10

Agent readiness — 24/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 0 / 10

Documented Reversibility 0 / 6

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 0 / 7

Typed Event Surface 6 / 6

Agent Skills 5 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Delegated User Identity 0 / 6

Protected Resource Metadata 0 / 5

Registration Without a Human 0 / 6

Agentic Commerce Well-Known Document 0 / 5

Create-or-Update Ergonomics could not be measured. We hold no machine-readable contract for this provider to read, so there is nothing to measure a write surface against. Excluded rather than scored zero: never-measured and measured-empty are different facts. Publishing an OpenAPI is what makes this facet — and several others — scorable at all.

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/sonos: open an issue to ask a question, or submit a pull request to add artifacts. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

APIs 1

Individual APIs this provider publishes, each with its own machine-readable definition.

Sonos Control API

Cloud-based REST API for controlling Sonos players and groups: playback, volume, grouping, favorites, playlists, home theater, audio clips, and cloud-queue playback sessions, wi...

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Sonos Events Webhooks

ASYNCAPI

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Sonos Authentication

oauth2 · 1 scheme

SECURITY

Sonos Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Sonos Scopes

1 scope · authorizationCode

1 scopes

SCOPES

Resources

Get Started 3

Portal, sign-up, and the first successful call

DeveloperPortal

DeveloperPortal

GettingStarted

GettingStarted

SignUp

SignUp

Documentation 2

Reference material describing how the API behaves

Documentation

Documentation

APIReference

APIReference

Agent Surfaces 3

MCP servers, agent skills, and machine-readable catalogs

WellKnown

WellKnown

X-MCPServerCandidate

X-MCPServerCandidate

AgentSkill

AgentSkill

Design & Contract 6

Pagination, idempotency, versioning, errors, and events

Lifecycle

Conventions

Webhooks

Conformance

ErrorCatalog

DataModel

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrganization

GitHubOrganization

Access & Security 3

Authentication, authorization, and security posture

Authentication

Authentication

OAuthScopes

OAuthScopes

DomainSecurity

DomainSecurity

Operate 2

Status, limits, changes, and where to get help

Support

Support

StatusPage

StatusPage

Company 1

The organization behind the API

Website

Website

Source (apis.yml)

aid: sonos
name: Sonos
description: Sonos is a consumer audio company whose wireless home-sound systems are controlled programmatically through the
  Sonos Control API — a cloud-based REST API that lets third-party integrations discover a household's players and groups
  and drive playback, volume, grouping, favorites, playlists, home theater options, audio clips, and cloud-queue sessions.
  The API authenticates with OAuth 2.0 (authorization code grant) using the single playback-control-all scope, is organized
  into per-resource namespaces (households, groups, groupVolume, playback, playbackMetadata, playbackSession, playerVolume,
  favorites, playlists, audioClip, homeTheater), and delivers real-time state through an event-subscription (webhook callback)
  model.
url: https://raw.githubusercontent.com/api-evangelist/sonos/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- redpoint-ventures
x-tier: profiled
x-tier-reason: has-public-api
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: false
  label: Hosted service · you call their endpoint
  confidence: medium
  source:
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
specificationVersion: '0.23'
created: '2026-07-17'
modified: '2026-07-21'
tags:
- Company
- Consumer
- Audio
- Music
- Smart Home
- IoT
- Streaming
- Speakers
- Home Automation
- Voice
image: https://www.sonos.com/apple-touch-icon.png
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
apis:
- name: Sonos Control API
  description: 'Cloud-based REST API for controlling Sonos players and groups: playback, volume, grouping, favorites, playlists,
    home theater, audio clips, and cloud-queue playback sessions, with OAuth 2.0 auth and event subscriptions.'
  humanURL: https://docs.sonos.com/reference
  baseURL: https://api.ws.sonos.com/control/api/v1
  tags:
  - Audio
  - Music
  - Playback
  - Smart Home
  properties:
  - type: APIReference
    url: https://docs.sonos.com/reference
  - type: Documentation
    url: https://docs.sonos.com/docs
  - type: GettingStarted
    url: https://docs.sonos.com/docs/authorize
  - type: Authentication
    url: authentication/sonos-authentication.yml
  - type: OAuthScopes
    url: scopes/sonos-scopes.yml
  - type: Conventions
    url: conventions/sonos-conventions.yml
  - type: Webhooks
    url: asyncapi/sonos-events-webhooks.yml
  - type: ErrorCatalog
    url: errors/sonos-problem-types.yml
  - type: DataModel
    url: data-model/sonos-data-model.yml
  - type: X-MCPServerCandidate
    url: mcp/sonos-mcp.yml
    note: 'Renamed from MCPServer 2026-09-03 (roadmap#247): the manifest self-describes as status: candidate — a tool list
      derived from the published API contracts, not an existing server. The scorer already read the manifest and reported
      mcp_server correctly; the MCPServer type was crediting the artifact-type surfaces with a server that does not exist.'
  - type: AgentSkill
    url: skills/_index.yml
common:
- type: Website
  url: https://www.sonos.com/
- type: DeveloperPortal
  url: https://developer.sonos.com/
- type: Documentation
  url: https://docs.sonos.com/docs
- type: APIReference
  url: https://docs.sonos.com/reference
- type: GettingStarted
  url: https://docs.sonos.com/docs/authorize
- type: SignUp
  url: https://developer.sonos.com/
- type: Support
  url: https://support.sonos.com/
- type: GitHubOrganization
  url: https://github.com/sonos
- type: StatusPage
  url: https://status.sonos.com/
- type: Lifecycle
  url: lifecycle/sonos-lifecycle.yml
- type: Authentication
  url: authentication/sonos-authentication.yml
- type: OAuthScopes
  url: scopes/sonos-scopes.yml
- type: Conventions
  url: conventions/sonos-conventions.yml
- type: Webhooks
  url: asyncapi/sonos-events-webhooks.yml
- type: WellKnown
  url: well-known/sonos-well-known.yml
- type: Conformance
  url: conformance/sonos-conformance.yml
- type: ErrorCatalog
  url: errors/sonos-problem-types.yml
- type: DataModel
  url: data-model/sonos-data-model.yml
- type: X-MCPServerCandidate
  url: mcp/sonos-mcp.yml
  note: 'Renamed from MCPServer 2026-09-03 (roadmap#247): the manifest self-describes as status: candidate — a tool list derived
    from the published API contracts, not an existing server. The scorer already read the manifest and reported mcp_server
    correctly; the MCPServer type was crediting the artifact-type surfaces with a server that does not exist.'
- type: AgentSkill
  url: skills/_index.yml
- type: DomainSecurity
  url: security/sonos-domain-security.yml
x-enrichment:
  date: '2026-07-21'
  status: enriched
  artifacts_added: 15
  pass: local-v1

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/sonos"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/sonos/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/sonos/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.