---
id: python-sonarqube-api
version: "2.0.5"
license: AGPLv3
license_treatment: agpl
maintenance: dormant
---

# python-sonarqube-api — Python wrapper for the SonarQube and SonarCloud API.

License: agpl · Maintenance: dormant · Downloads: 399.1K/mo

## What it is and what it does

python-sonarqube-api is a Python wrapper around SonarQube and SonarCloud's REST APIs. It abstracts HTTP request handling and authentication, allowing developers to interact with code quality analysis data via simple Python method calls instead of raw HTTP. The Community Edition (free, AGPLv3) supports approximately 40 API endpoints and is compatible with SonarQube 7.9.x through 8.9.x; a paid Professional Edition offers over 280 endpoints and broader version support.

The library is initialized with a SonarQube URL and either a token or username/password credentials, then used to query project metrics, issues, and other analysis results. It depends only on requests for HTTP communication. The package has been in production-stable status but has not received updates in 740 days, so it is suitable for stable, read-only workflows but may lag behind newer SonarQube features or security patches.

Use it for:

- Automate retrieval of code quality metrics and issue reports from SonarQube for CI/CD pipelines.
- Build dashboards or reports that aggregate SonarQube analysis data across multiple projects.
- Query SonarCloud results programmatically to enforce quality gates in development workflows.
- Integrate SonarQube findings into custom alerting or notification systems.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a Python client library for interacting with SonarQube and SonarCloud REST APIs, wrapping HTTP requests to simplify authentication and API calls.

Yes, if you need a lightweight Python wrapper for SonarQube or SonarCloud APIs and can accept AGPLv3 licensing constraints. The low install friction and stable API make it suitable for read-only workflows. However, the 740-day dormancy means no active maintenance—evaluate whether you need the Professional Edition's broader API coverage or can work within the Community Edition's 40 endpoints, and verify compatibility with your SonarQube version.

## Install

pip install python-sonarqube-api
uv add python-sonarqube-api
poetry add python-sonarqube-api

## Installing python-sonarqube-api

Before you install: Low install friction with a single runtime dependency (requests). Maintenance is dormant—no release in 740 days—so expect no active bug fixes or feature updates, though the package is marked as production-stable.

License in practice: Licensed under AGPLv3, which requires derivative works and modifications to be released under the same license and prohibits commercial use without source disclosure. This is a significant constraint for proprietary applications.

Quickstart:

pip install python-sonarqube-api

from sonarqube import SonarQubeClient

sonar = SonarQubeClient(sonarqube_url="http://localhost:9000", token='your_token')
# Now call API methods on sonar object

Requires a running SonarQube or SonarCloud instance accessible at the specified URL; authentication token or username/password credentials must be available.

Verify before relying:

- Whether the 40 supported APIs in Community Edition cover your specific SonarQube use cases.
- Current compatibility with SonarQube versions beyond 8.9.x LTS given the dormant maintenance status.
- Whether dormancy affects real-world reliability for stable, read-only API interactions.

## Package facts

- License: AGPLv3 (agpl)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 399.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

sonarqube api client, sonarcloud python wrapper, sonarqube rest api, code quality analysis api, sonar client library, code-quality, ci-cd-integration

[View on SkillFed](https://skillfed.io/packages/python-sonarqube-api) · [View on PyPI](https://pypi.org/project/python-sonarqube-api/)