Comuvi API

REST API for community management. Requires an API key (plan Gestor or Enterprise).

Authentication: Include your API key in the header X-API-Key: cv_your_key_here. Get your key from Administration → Plan → API Keys.
Base URL: https://my.comuvi.app/api

Announcements

GET/api/announcements

List all announcements for the community.

POST/api/announcements

Create an announcement. Body: {"title":"...","body":"..."}

Incidents

GET/api/incidents

List all incidents.

PATCH/api/incidents/:id

Update status. Body: {"status":"progress"}

Receipts

GET/api/receipts

List all receipts. Admin sees all; filters by unit for owners.

POST/api/receipts

Create receipt. Body: {"month":"...","amount":55,"concept":"...","per_unit":true}

PATCH/api/receipts/:id

Update status. Body: {"status":"paid"}

Members

GET/api/members

List all members with role and unit.

Units

GET/api/units

List all units in the community.

POST/api/units

Create a unit. Body: {"label":"2ºA"}

Documents

GET/api/documents

List all documents.

Votes

GET/api/votes

List all votes with status and results.

Events

GET/api/events

List upcoming events.

POST/api/events

Create event. Body: {"title":"...","starts_at":"2026-05-01T10:00","location":"..."}

Packages

GET/api/packages

List packages.

Surveys

GET/api/surveys

List all surveys.

Accounting

GET/api/accounting?year=2026&month=4

Financial summary with breakdown by unit and month.

GET/api/accounting/export?year=2026

Download CSV export of receipts.

Errors

{"error":"not_found"}           // 404
{"error":"forbidden"}            // 403
{"error":"plan_limit","feature":"api_access","upgrade_required":true} // 403 plan limit

Rate Limits

100 requests per minute per API key. Excess requests return 429 Too Many Requests.